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Preface 



Quelques jours seulement apres la sortie de Plone 2.0, nous sommes tres heu- 
reux d'assister a la parution de ce livre, et de voir que Plone est en train de 
gagner une telle popularite en France. Depuis ses debuts, l'accent a ete mis sur 
l'integration de differentes langues afin de fournir aux utilisateurs et aux deve- 
loppeurs la meilleure experience possible dans leur langue maternelle. La large 
diffusion de Plone en France nous montre que nous avons reussi a atteindre cet 
objectif, et nous sommes impatients de decouvrir ce que le futur nous apportera 
de la part des developpeurs francais, qui jouent deja un role important au sein de 
la communaute Plone. 

Oui, la communaute Plone francaise a ete l'un des tout premiers points d'entree 
de Plone en Europe - depuis la sortie de la version 1.0 lors de la conference 
Solutions Linux a Paris - et aura toujours une place a part dans l'histoire de ce 
logiciel. Les developpeurs francais ont contribue a de nombreuses parties 
importantes de l'infrastructure de Plone ; ils ont egalement realise un grand tra- 
vail afin de faire connaitre ce produit au-dela de la communaute Open Source et 
de prouver qu'il apportait une solution serieuse, documentee, souple et innova- 
trice sur le marche de la gestion de contenu, beneficiant d'une assistance tech- 
nique de qualite. 

Avec Plone 2.0, nouvelle version majeure de notre plate-forme, nous avons atteint 
une nouvelle etape dans de nombreux domaines. Utilisateurs, developpeurs, gra- 
phistes ou administrateurs d'une solution Plone vont beneficier d'avancees qui 
vous seront presentees dans cet ouvrage : rinternationalisation complete des inter- 
faces bien sur, mais aussi la gestion plus fine de la collaboration et du partage 
d'informations notamment grace a l'ajout de la notion de groupes, la saisie 
WYSIWYG des documents issus des applications bureautiques, l'affichage sur tous 
types de terminaux, le decoupage fin des feuilles de styles, le developpement 
rapide de nouveaux types de documents (ArcheTypes), la montee en charge de la 
plate-forme, rinstallation ou la configuration de nouveaux composants a travers 
des panneaux de configuration sont, entre autres, au rendez-vous ! 



Tout cela conserve la souplesse inedite de developpement et de deploiement du 
serveur d'application sous-jacent, Zope. Bien sir, la migration des sites existants 
Plone 1.0 est possible, afin de permettre aux utilisateurs de beneficier des fonc- 
tionnalites de gestion de contenu, de gestion electronique de documents, de 
dematerialisation de procedures, de portails d'entreprise, de bases documen- 
taires ou encore d'e-learning. 

Bref, nous avons maintenant un socle technique solide sur lequel construire le 
futur de Plone. L'annee ecoulee a ete agitee, productive, mais surtout recom- 
pensee, et la diffusion de Plone a travers le monde a depasse nos esperances. 
Cher lecteur, nous esperons que vous apprecierez cet ouvrage, tout comme nous 
avons eu du plaisir a travailler en cooperation avec ses auteurs afin d'amener 
Plone sur le marche francais. Avec l'utilisation croissante de l'Open Source en 
Europe, il nous appartient de dessiner le futur ; nous esperons que vous nous 
rejoindrez dans ce voyage. 



Alexander Limi et Alan Runyan 
Fondateurs du projet Plone. 



Avant-propos 



Plone est un outil de gestion de contenu : il sert a mettre en ligne (Internet, 
intranet) de l'information, pour pouvoir l'organiser et la traiter sans aucune con- 
naissance technique liee au media manipule. 

Dans le monde des outils de gestion de contenu, Plone tient une place toute 
particuliere, car il est tres largement capable de rivaliser avec les meilleurs logi- 
ciels commerciaux du marche. Le marche de la gestion de contenu est particu- 
lierement concurrentiel : debut 2004, une etude recense pas moins de 
870 offres. Sur ces offres, une grosse dizaine domine le marche, chaque produit 
etant ancre sur un segment de marche ou une specificite. Les couts de ces solu- 
tions ne sont pas du tout negligeables, avec notamment des licences a plusieurs 
dizaines voire centaines de milliers d'euros. Plone est atypique : c'est une solu- 
tion Open Source qui vient deranger ce monde commercial, qui couvre le 
spectre fonctionnel de la plupart de ces outils, avec une ouverture sans prece- 
dent. Le fait que l'outil soit egalement gratuit commence a chambouler la 
donne. 

Dans le monde Open Source, la gestion de contenu est un sujet qui suscite de 
l'interet. On retrouve deux grandes categories d'outils : les outils concus dans un 
garage pour repondre a un besoin particulier et dont on diffuse le code source, et 
les outils pour lesquels la phase amont de reflexion et de maturation a ete plus 
aboutie, et qui tentent d'apporter des solutions generiques a des problematiques 
repandues. C'est dans la premiere categorie que Ton trouve le plus d'outils, sou- 
vent realises avec PHP On trouve parmi eux des logiciels d'excellente facture, 
particulierement efficaces a resoudre en un temps tres court et a un cout presque 
nul une problematique precise. La difficulte dont ces outils ne savent en general 
pas bien se sortir est leur capacite (si elle est necessaire) a evoluer dans une 
direction pour laquelle ils n'ont pas ete concus : les extensions et evolutions de 
l'outil peuvent alors etre extremement couteuses, pour leur creation, mais aussi 
pour les maintenir. 



ALTERNATIVES Logiciels 
de gestion de contenu 



0 http://www.spip.net 

0 http://phpnuke.org/ 

0 http://www.squishdot.org/ 

0 http://cocoon.apache.org 

0 http://jakarta.apache.org/tomcat/ 

Q http://www.jboss.org 

0 http://cmf.zope.org 



Parmi ces solutions, on retiendra notamment SPIP et les families d'outils 
derives de PHPNuke . Dans le monde de Zope, l'outil SquishDot 0 a eu 
son heure de gloire. Ces outils sont tres repandus et generalement assez faciles a 
installer, parameter et utiliser. 

Dans la seconde categorie, on retrouve des solutions plus « lourdes », plus 
« reflechies », pour lesquelles la courbe d'apprentissage est plus raide. La plupart 
de ces outils sont ecrits en Java, quelques-uns avec PHP Ces solutions sont plus 
utilisees sur des projets importants, mais reclament des phases de conception et 
de developpement bien plus longues. Les couts de realisation (temps, machine, 
hommes) sont eux aussi plus grands. Nombre de ces outils fournissent une API 
ou un framework, qu'il convient de confier a une equipe de developpeurs avertis. 
Les solutions obtenues sont generalement de tres bonne facture, mais parfois un 
peu penibles a faire evoluer. Parmi ces solutions, on retrouve notamment 
Cocoon O, les solutions basees sur Tomcat 0 ou JBoss 0 mais aussi CMF 0. 
Ces outils sont bien moins repandus que les precedents, car bien plus difficiles a 
mettre en ceuvre. 

Plone appartient plutot a la seconde categorie, mais possede un avantage con- 
currentiel enorme : il est tres simple a installer et est immediatement utilisable, 
notamment grace a son ergonomie hors-pair et aux tres nombreux composants 
disponibles. La communaute qui anime Plone est tres large (plusieurs milliers 
d'individus et/ou societes) et tres active, presente sur tous les continents. 



Plone : pour quelles applications et quels 
utilisateurs ? 

Plone a ete concu pour etre evolutif, depuis sa genese. Son positionnement est 
double : 

• II est parfaitement utilisable par une PME pour mettre en place son site 
Internet et son intranet, avec de nombreux services : c'est l'utilisation 
« LEGO™ » de Plone, ou Ton assemble des composants existants pour 
construire ses sites. 

• II convient egalement parfaitement comme base a des projets bien plus 
ambitieux, ou Ton va reutiliser de nombreux composants existants, et en 
developper de nouveaux pour resoudre des problematiques non couvertes. 

Les auteurs de ce livre utilisent quotidiennement l'outil dans ces deux configu- 
rations. 



VIII 



Structure de l'ouvrage 



Dans cet ouvrage, nous allons nous attacher a vous faire decouvrir ces deux 
aspects de Plone, au travers d'un exemple reel : nous allons construire ensemble 
un intranet d'entreprise. Le cheminement choisi est le suivant. 
Le chapitre 1 : seule partie theorique de l'ouvrage, elle s'attache a presenter la 
gestion de contenu du point de vue du besoin, en decrivant les avantages et 
inconvenients de ces solutions. Ce chapitre est destine a tous les profils, mais 
sera particulierement apprecie des decideurs. 

Le chapitre 2 : visite guidee du site a realiser. Sur la base de l'etude de cas, le 
lecteur decouvre un site Plone, avec les services vus du point de vue de l'utilisa- 
teur et du contributeur. 

Les chapitres 3 et 4 : installation et configuration de Plone. Plone peut etre ins- 
talle sur un serveur Unix, mais aussi sur un poste de travail MS-Windows™. 
Le chapitre 5 : mise en couleur du site Plone, adaptation visuelle et graphique 
du site. 

Le chapitre 6 : creation et adaptation de nouveaux workflows pour gerer du contenu. 
Le chapitre 7 : adaptations fonctionnelles de Plone, creation de nouveaux types 
de contenus (atomes d'information du systeme). 

Les chapitres 8 et 9 : mise en production, montee en charge. Ces chapitres sont 
plutot destines aux administrateurs systeme. 

Le lecteur retrouvera en annexe des complements d'informations et des refe- 
rences techniques (API). 

A qui s'adresse ce livre ? 



Ce livre s'adresse a plusieurs profils. Cette approche nous a semble logique dans 
la mesure oil un projet fait generalement intervenir toutes ces personnes (parfois 
representees par le meme individu ;) ). 
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Bien entendu, les lecteurs curieux pourront s'essayer a lire les chapitres qui ne 
leur sont pas directement destines ! 



ALLER PLUS LOIN Zope 

II est a noter que le present cahier est un excellent 
complement au livre Zope, 2e edition. Le present 
ouvrage est plus oriente « etude de cas » et se 
presente done comme un grand tutoriel, sans 
vocation d'exhaustivite ; le livre Zope est quant a 
lui bien plus fourni, traitant de plus de sujets et 
plus en profondeur. 

£Q O.Deckmyn, P. -J. Grizel, Zope 2e edition, 
Eyrolles 2003. 
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La gestion de contenu est I'ensemble des concepts et outils visant a resoudre les 
problemes de production de contenu des sites web. El le cherche a integrer de 
maniere intelligente les differents acteurs du site et les differents supports de 
diffusion de I'information. 



La gestion de contenu 



La gestion de contenu dynamique et redactionnel 
d'un site web doit se faire rapidement et facile- 
ment. II faut pour cela mettre en place un systeme 
flexible qui permette une mise a jour facile : la cor- 
rection, I'ajout de textes, photos ou fonctions mul- 
timedias doivent pouvoir etre faits par les utilisa- 
teurs sans aide exterieure. 



La gestion de contenu 



Pour mieux comprendre le role et les avantages de la gestion de contenu, il 
convient de s'interesser a revolution du Web et plus particulierement de la 
creation des sites web. 

Les premiers sites web ont ete edites par des equipes scientifiques animees 
par le seul besoin de mettre en ligne des informations. Le style etait austere, 
mais l'essentiel etait presente. 

Puis, de plus en plus de passionnes se sont rues sur la manne du Web, y 
apportant leur touche de gaiete personnelle. lis eurent rapidement besoin 
d'outils plus « visuels », d'ou lemergence de logiciels d'edition de pages 
HTML tels que Macromedia Dreamweaver, Microsoft FrontPage, etc. 

Les entreprises ont a leur tour jete leur devolu sur les fantastiques possibilites 
du Web et ont confie a des specialistes le soin de creer, maintenir et mettre a 
jour leur site. Le metier de « webmestre professionnel » etait alors ne ! 

Cependant, avec l'explosion du Web et la professionnalisation de l'activite 
de creation de sites {startups et « dotcom », sites dynamiques, sites mar- 
chands, etc.), le webmestre est devenu victime de son succes. D'une part, la 
gestion des pages statiques pose rapidement de nombreux problemes techni- 
ques des que le site devient consequent. 



Systeme de gestion de contenu (CMS) 

Un systeme de gestion de contenu (Content Management System) est 
I'ensemble des outils permettant de mettre en ceuvre la gestion de 
contenu. II se compose en general de nombreux modules fournissant 
des services : gestion des utilisateurs, creation et edition de contenu, 
indexation et recherche, etc. 

Un systeme de gestion de contenu est generalement compose de 
modules fournissant des fonctionnalites essentielles sur lesquelles 
I'utilisateur developpe ses applications. Les fonctionnalites que Ton 
retrouve dans les produits du marche ayant atteint un certain niveau 
de maturite sont : 

• la gestion des utilisateurs et de leurs droits ; 

• la creation et I'edition de contenu ; 

• le stockage du contenu . 

• les metadonnees (ensemble de proprietes decrivant le contenu) ; 

• la gestion de la qualite de I'information ; 

• I'indexation et la recherche ; 

• la gestion de I'interface utilisateur ; 

• la syndication (regroupement d'informations provenant de diffe- 
rents sites) ; 



• la gestion des versions ; 

• et tous les services autour de ce tronc commun de la gestion de 
contenu. 

Quelques CMS Open Source 

Pour le socle technique de votre projet, choisissez parmi les solutions 
Open Source les plus populaires du moment : 

• Tiki CMS/Groupware - http://tikiwiki.org (solution PHP) ; 

• Typo3 - http://typo3.org (solution PHP) ; 

• PHPNuke - http://phpnuke.org/ (solution PHP) ; 

• Drupal - http://drupal.org (solution Java) ; 

• Open ACS - http://openacs.org (solution Java) ; 

• Bricolage - http://bricolage.cc (solution HTML::Mason / Perl) ; 
et bien sur : 

• Plone 2 - http://plone.org (solution Zope / Python). 

Une liste complete des outils de gestion de contenu Open Source est 
disponible sur le site de I'OSCOM : 

► http://www.oscom.org/matrix/ 
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D'autre part, le webmestre doit sans cesse se former aux nouvelles technolo- 
gies, et il a de plus en plus affaire a des interlocuteurs, utilisateurs, clients ou & 
partenaires financiers, qui ne maitrisent pas le langage technique - et veulent 
encore moins en entendre parler. L'entreprise doit done adopter une 
demarche rationnelle pour la gestion de son site web. 

Face a cet environnement humain et technologique de plus en plus com- 
plexe, la necessite d'organiser la gestion des sites s'imposait. Que ce soit la 
charte graphique, la creation, la maintenance, la mise a jour, revolution, tout 
doit pouvoir etre gere, decide, mis en ceuvre a differents niveaux et/ou par 
differentes personnes. 

De la sont nes le concept de gestion de contenu et les systemes de gestion de 
contenu. 



Domaines ^application 

La gestion de contenu permet d'industrialiser la mise en oeuvre des sites web 
ayant des contraintes fortes : forte audience, mise a jour frequente du con- 
tenu, differents groupes d'utilisateurs avec differents droits ou privileges, 
temps de telechargement des pages, contenu multimedia, transactions com- 
merciales, etc. 

Parmi les applications typiques d'un systeme de gestion de contenu, on peut 
citer le site editorial, la communaute en ligne, les intranets et les bases de 
connaissances. 



Journaux en ligne, webzines et weblogs 

Le site editorial est le genre le plus repandu sur le Web du fait de sa nature 
de media partage. II permet a un individu ou a un groupe d'individus de se 
positionner comme source d'information, « infomediaire », ou veilleur sur 
des sujets specifiques. II se presente sous differentes formes selon le modele 
economique, l'objectif vise par le createur, et la tendance du moment. 

Les sites editoriaux les plus frequemment rencontres sont les portails 
d'information tels que News.com ou ZDNet, les journaux en ligne tels que le 
lemonde.fr, les « webzines » qui sont plus specialises sur un sujet donne, et les 
« weblogs » (« webillards » en francais). Ces derniers, bien que soumis a des 
contraintes differentes de celles du monde industriel, sont actuellement tres 
populaires dans le monde des sites personnels et du journalisme amateur. 



CULTURE « Blogosphere » 



Les « weblogs » constituent aujourd'hui l'un des 
domaines les plus creatifs du Web, integrant regu- 
lierement de nouvelles tendances ou 
technologies : K-Logs, MoBLogs, Wikilogs, etc. 
Cette « technosphere » particuliere ou se rejoi- 
gnent producteurs de contenu independants, jour- 
nalistes, leaders d'opinion, activistes, entrepre- 
neurs et autres pionniers d'lnternet, a ete designee 
outre-Atlantique sous le terme federateur de 
« Social software ». 
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La communaute en ligne 

Le site est ouvert a des contributeurs sans limita- 
tion en nombre, des lors qu'ils ont du contenu a 
proposer a la communaute, qu'ils sont inscrits et 
qu'ils respectent la charte editoriale du site. Des 
relecteurs sont charges de valider le contenu con- 
tribue avant qu'il ne devienne public. Les autres 
membres peuvent egalement contribuer en appor- 
tant des commentaires sur chaque contenu publie. 
Ainsi, la communaute s'enrichit par la participa- 
tion de tous. 

Parmi les exemples de sites communautaires con- 
nus, on peut citer Slashdot.org (/.), kuro5yin.org, 
ciao.fr, ou encore Zopera.org. 



Communautes en ligne 

Une communaute en ligne reunit des internautes qui partagent des centres 
d'interet d'ordre general ou professionnel, en leur offrant la possibilite de 
contribuer a l'information sous forme d'articles, et d'alerter la communaute 
sur des informations vues ailleurs sur le Web. Un espace de forum permet 
par exemple aux membres de la communaute de reagir pour donner leur avis 
sur les contributions ou completer l'information. 

La politique editoriale choisie par les createurs du site determine s'il est 
« modere » ou pas. S'il est modere, un responsable appele moderateur est 
averti lors de l'arrivee d'une nouvelle contribution ; apres lecture, celui-ci 
decide de valider ou non la publication. Si le site n'est pas modere, le con- 
tenu est accepte d'office et done visible des sa publication par le contributeur. 
Cette demarche induit tous les risques lies aux habituels debordements 
humains... Un systeme non modere n'est pas pour autant un systeme 
anarchique : un responsable doit toujours pouvoir intervenir sur un contenu 
pour loter de la vue du public si besoin est. 



La base de connaissances 



Le contenu de la base de connaissances est le 
capital intellectuel d'une entreprise, d'une organi- 
sation ou d'un groupe d'individus. Comme la com- 
munaute en ligne, elle requiert I'implication des 
membres, principaux beneficiaires de ce capital. 



Bases de connaissances 

II s'agit ici d'applications intranet ou Internet permettant de capitaliser 
l'information et le savoir-faire au sein de l'entreprise ou d'une communaute : 
idees, documentation, procedures, etc. Cette capitalisation doit se faire de 
maniere structured et coherente. De fait, elle requiert des technologies capa- 
bles de gerer des informations aussi bien structurees que non structurees. 
D'autre part, ces technologies doivent etre au service des employes ou indi- 
vidus qui sont a l'origine de ce capital, en etant flexibles, simples d'utilisation 
et en aidant a valoriser leur travail. 



Presentation de la solution Plone 



Statut de Plone 



Plone est actuellement disponible en version 2.0 et 
beneficie d'une communaute d'utilisateurs et de 
developpeurs tres active. 

A I'heure ou nous merlons sous presse, la 
version 2.1 est deja en cours de developpement. 



Plone est un systeme de gestion de contenu (en anglais Content Management 
System ou CMS) base sur Zope et le CMF [Content Management Fra- 
mework), la librairie de composants qui complete Zope en fournissant un 
ensemble de services aux concepteurs de sites, aux integrateurs d'applica- 
tions et aux gestionnaires de contenus. 

Le CMF fournit une librairie de composants, chacun specialise dans le trai- 
tement d'une problematique precise. Chacun des composants se concentre 
sur son perimetre fonctionnel et collabore avec les autres via des interfaces. 
Le developpeur d'applications ou l'integrateur peut directement utiliser leurs 
services via le Web (typiquement, via l'appel d'un script Python ou autre 
objet executable). 
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Zope, un serveur d'applications avec un modele de developpement objet 

Zope est une plate-forme de developpement d'applications web basee sur Python. Zope 
integre un grand nombre d'outils et de fonctionnalites, dont un gestionnaire de bases de 
donnees objet, un module de publication d'objets web et un langage de creation dynami- 
que de pages. Contrairement aux autres solutions du marche, la finalite de Zope n'est pas 
de publier des « pages » mais des « objets » pouvant etre assembles automatiquement a 
partir de composants dont le comportement, les donnees et I'apparence sont configurables 
par le concepteur du site. Cette approche rend Zope beaucoup plus apte que d'autres pro- 
duits a faciliter la publication de contenu web. 
CD Zope, P.-J. Grizel et 0. Deckmyn, Editions Eyrolles (2003). 



ARCHITECTURE Architecture de composants 



Une evolution majeure de Zope introduite avec le 
Content Management Framework est la notion de 
« composants ». Cette architecture, qui sera gene- 
ralise avec Zope 3, permet de rationaliser le deve- 
loppement en deleguant les fonctionnalites a des 
composants objets specialises. 



Le principal avantage est le gain de productivite pour les developpeurs. lis 
n'ont plus a reinventer la roue, et les differents modules applicatifs collabo- 
rent facilement ensemble puisqu'ils se basent sur un referentiel de compo- 
sants avec des interfaces connues. Le developpeur peut egalement fournir 
une nouvelle implementation d'un composant existant. Ainsi, parce qu'il 
respecte les memes interfaces, son nouveau composant peut remplacer le 
composant defini par defaut au sein du CME Par exemple, le composant 
permettant 1'authentification des utilisateurs de l'application aura differentes 
implementations selon que la source des utilisateurs est embarquee au sein 
du serveur Zope (comptes stockes dans le conteneur acl_users ou Standard 
User Folder) ou que la source est un annuaire LDAP (via un LDAP User 
Folder). 



LDAP 

LDAP {Lightweight Directory Access Protocol) est un 
protocole d'echange de donnees relativement sim- 
ples stockees dans une base arborescente. C'est un 
protocole tres utilise pour gerer les annuaires, tels 
que Active Directory de Microsoft, OpenLDAP ou 
Novell Directory. 

d lope, P.-J. Grizel et 0. Deckmyn 

(Eyrolles 2003) pour une presentation de 
Integration Zope/LDAP. 



Les services de Plone 

Vbici une presentation rapide des services que Ton retrouve dans Plone. 



Gestion des membres 

Par defaut, le systeme fournit a chaque membre un espace personnel pour 
1' organisation et l'edition du contenu auquel il contribue. Ainsi, si vous choi- 
sissez un modele collaboratif decentralise, le contenu du site n'est pas 
« stocke » a l'endroit ou il sera affiche, mais reparti dans les espaces person- 
nels des membres. Le systeme met egalement en oeuvre la gestion des profils 
des membres avec leurs options personnelles. 



Ce service est fourni par les composants 
portaljnembership et portaTjnemberdata. 



Gestion des groupes de membres 

Plone 2 permet la gestion des groupes grace au systeme d'authentification 
integre GroupUserFolder. Chaque groupe peut alors disposer de son « espace 
de groupe » ou les membres du groupe ont les droits necessaires pour creer et 
gerer leur contenu commun. Le systeme met egalement en oeuvre la gestion 
des profils des groupes. 



Ce service est fourni par les composants 
portal_groups et portal _groupdata. 
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Gestion de I'interface utilisateur 



Cette gestion est assuree grace au composant 
portal_skins. 



Avec un systeme d'interface utilisateur reposant sur le nouveau concept des 
Skins, Plone 2 met reellement en ceuvre la separation du contenu, de la 
logique applicative et de la presentation. 

En voici une explication tres rapide : le contenu est gere via les types de con- 
tenus, la logique Test par l'application et le workflow, et la presentation par 
les skins (CSS2). Ce systeme permet de deleguer le rendu de tel ou tel objet a 
une methode specialisee pour cette tache. II permet de plus de proposer plu- 
sieurs presentations pour un meme site. On peut aussi utiliser ce principe 
pour concevoir un site multicible (HTML, WAP, XML, etc.) ou multi- 
lingue. Plone 2 propose un systeme de skin qui permet de modifier tout ou 
partie de I'interface utilisateur sans jamais changer aucun des modeles 
HTML fournis, mais en agissant au niveau de la feuille de style (CSS2). 



Cette gestion est assuree grace a plusieurs compo- 
sants qui collaborent, principalement : portal_ 
types, portal _factory , porta~l_skins 
et porta~Lform_cont roller. 



Gestion du processus de creation et d'edition du contenu 

Un type de contenu est une definition faite au sein d'une application Plone 
pour permettre la gestion du contenu. Le type de contenu s'appuie sur la 
classe d'objet, mais prend en compte d'autres parametres. Les types de con- 
tenu par defaut (par exemple Actual ite, Document ou Lien) peuvent etre 
etendus ou modifies pour devenir de nouveaux types. Le concepteur definit 
le comportement du nouveau type et Plone l'expose aux membres du site 
pour les assister dans leur publication. 

Le type de contenu est l'atome de l'information d'un site Plone. 



Exemples de types de contenu 

• Actualite 

• Document 

• Article 

• Dossier 

• Offre d'emploi 



Ce service est fourni par le composant 
portal_workflow en collaboration avec 
le composant portal_types. 



Gestion du workflow de publication 

Pour chaque type de contenu, le concepteur du site peut determiner tous les 
etats possibles, les transitions et les acteurs. Le niveau de parametrage du 
workflow est maximal ; le produit d'extension DCWorkflow permet meme 
de « dessiner » une machine a etats via le Web. 
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Workflow 

DCWorkflow est un outil de workflow « oriente document ». II decrit bien les differentes 
etapes d'un document dans le site : ses etats, les transitions pour passer d'un etat a I'autre. 
II existe cependant un autre type de workflow: le workflow de processus, qui permet de 
decrire et d'assister un processus (et non plus un cycle de vie de document) dans le site. 
Cela peut par exemple concerner le processus d'acheminement du courrier dans une entre- 
prise ou une administration (reception, ouverture, cycles de lecture, cycles de reponses, 
reponse, etc.). Un tel composant existe deja pour Plone et se nomme CMFOpenFlow. 
► http://www.reflab.it/community/Openprojects 

Comme tous les composants de Plone, le composant qui gere les workflows peut se changer, 
et Ton peut utiliser a la fois DCWorkflow et CMFOpenFlow sur un meme site, en fonction 
du besoin. 



Workflow pas f rancais ? 

Non, le mot workflow n'est pas francais. . . mais nous ne connaissons pas de (bonne) traduc- 
tion en francais. Certains disent « circuits de validation », mais le terme est en fait inexact 
et incomplet. 

D'apres le dictionnaire des expressions informatiques en ligne, le terme se traduit par 
« gestion electronique de processus » et trouve la definition suivante : 
« Outil decisionnel cooperatif qui s'attache a optimiser et rationaliser les flux d'information 
et les procedures de travail. Exemple : on pourra mettre en place un circuit automatique de 
circulation et de validation des documents sous format electronique, necessaires a I'activite 
de I'entreprise. » 
► http://www.dicofr.com 



Gestion de I' indexation et du moteur de recherche 

Toutes les instances de contenus creees sont indexees dans un ZCatalog 
(moteur de recherche objet, integre a Zope), qui est tres fortement sollicite 
pour le rendu des pages. Le choix des objets rendus sur une page se fait sys- 

tematiquement via une requete sur le ZCatalog. Plone est une application 

. . i> ^.-i- j rjr^ . , i rj r ■ Ce service est fourni par le composant 

qui est vraiment centree sur I utilisation du ZUatalog de Zope et en fait un , * * 

n . - c i ■ • • j> • j> 11 r portal_catalog. 

usage intensii, lui permettant ainsi d avoir d excellentes performances. 



B.A.-BA Indexation 

L'indexation consiste a conserver dans une base de donnees des liens vers certains attributs 
d'un objet (par exemple I'auteur du contenu en question), et de fournir un service qui per- 
met de retrouver tres rapidement cette information. Ainsi, si Ton recherche la liste des con- 
tributions d'un auteur particulier sur le site, on utilise le moteur d'indexation du site, qui va 
retrouver I'information en quelques milli-secondes, sans avoir a parcourir toute la base de 
donnees pour retrouver cette information. 
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Gestion des metadonnees 

On peut decrire tous les contenus du site a l'aide d'un ensemble de metadon- 
Ce service est fourni par le composant CMF nees definies par le standard Dublin Core. Les principaux elements de des- 
portaljnetadata. cription actuellement pris en charge sont : le titre, la description, le sujet 

(liste de mots-cles), le format, la langue, l'auteur, date de publication et de 
validite, les contributeurs et les droits (copyright), etc. 



JARGON Meta-informations, meta-donnees ou meta-datas 

Ces trois termes designent la meme notion : un jeu de donnees decri- 
vant le contenu auquel elles sont associees. Un jeu de meta-informa- 
tions permet done de decrire I'information en question (le contenu). 
Ainsi, on retrouve habituellement les meta-informations suivantes : 

• auteur 

• date de publication 

• date de validite 

• copyright 

• etc. 

Ces informations sont fondamentales dans un systeme de gestion de 
contenu, car elles participent enormement a la qualite de I'informa- 
tion contenue dans la base, et done a sa reutilisabilite. 



CULTURE RDF 

RDF {Resource Description Framework) est une technologie developpee 
par le W3C [World Wide Web Consortium) pour permettre la description 
de ressources sur le Web (sites, applications, contenus). RDF s'appuie 
sur la technologie XML (extensible Markup Language) pour la syntaxe 
d'echange des donnees. 

CULTURE Dublin Core (DC) Metadata 

Le Dublin Core Metadata Initiative est une organisation qui travaille 
a definir des standards d'utilisation des metadonnees pour les appli- 
cations. Le Dublin Core Metadata Element Set definit les attributs de 
description des donnees en s'appuyant sur la technologie RDF. 

► http://dublincore.org/ 

Autre standard de metadonnees 

• Learning Objects Metadata (LOM) 



Ce service requiert Integration d'une nouvelle bri- 
que logicielle du CMF qui n'est pas encore disponi- 
ble dans la distribution standard: CMFStaging. 
Le lecteur curieux pourra chercher dans le referen- 
tiel de code source de Zope via un acces CVS {Con- 
current Versionning System) en lecture : 
► http://cvs.zope.org/CMF/CMFStaging/ 



Gestion des versions 

La gestion des versions permet de manipuler differentes versions d'un con- 
tenu, ou d'un ensemble de contenus (par exemple, toute une partie du site). 
Typiquement, chaque contributeur peut revenir a une version precedente de 
son contenu, et le webmestre peut rendre publique une nouvelle version du 
site apres l'avoir testee, tout en ayant la possibilite de retablir la version pre- 
cedente si cela s'avere necessaire. 

Ainsi, en cas d'erreur faite a un moment de la vie du contenu, il est possible 
« d'annuler » les modifications les plus recentes pour revenir a une version 
plus ancienne. 



Ce service est fourni par le composant CMF 
portal_syndi cation. 



Gestion de la syndication 

Le CMF (et done Plone) vous permet d'exposer n'importe quel contenu de 
votre site sous forme de RSS XML. Ainsi, d'autres sites peuvent s'abonner 
aux informations de votre site pour les diffuser. 
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B.A.-BA Syndication 

La syndication permet de partager de I'information entre differents sites web. A partir d'un 
site fournissant cette application, I'internaute peut consulter des contenus (generalement 
de type news) provenant de differents sites sans etre oblige d'aller sur les sites en question. 
RSS (RDF Site Summary) est le format de fichier de description de ressources le plus utilise 
pour la syndication.il permet de decrire un ensemble de contenus, offrant pour chacun un 
lien vers le texte complet. 



Avantages de Plone pour les gestionnaires de contenu 
La mise en ligne du contenu devient facile 

D'une part, la publication du contenu ne necessite qu'un simple navigateur 
web. Ainsi, le producteur de contenu peut publier ses informations sur le site 
de partout et a tout moment. Ceci est particulierement indispensable pour 
des entreprises avec des equipes eclatees, qui travaillent a distance ou avec 
des horaires decales. 

D'autre part, l'outil de publication permet aux redacteurs d'injecter des 
documents bureautiques, en prenant en charge les conversions de format 
necessaires. La flexibilite de la publication vient du fait que le contenu mis 
en ligne est stocke dans une base de donnees. En effet, il est ainsi accessible 
et modifiable par les redacteurs identifies, et manipulable par tous les 
moyens de traitement informatique. 

La publication du contenu peut etre organisee 

La complexity de la production de contenu non seulement cree des goulots 
d'etranglement qui handicapent l'entreprise, mais egalement decourage 
l'implication des employes, clients et partenaires, fournisseurs potentiels de 
contenu a valeur ajoutee. Grace a la gestion de contenu, tout collaborates 
de l'entreprise, detenteur d'information, peut, a l'interieur de son perimetre 
de responsabilite, produire son contenu sur le site, sans empieter sur le tra- 
vail de son collegue, pair ou partenaire. Tous les maillons de l'organisation 
participent ainsi a la vie de « l'entreprise virtuelle » avec un certain degre 
d'autonomie. II en decoule une valorisation du travail des collaborateurs et, 
par consequent, des gains en productivite et en opportunites commerciales 
pour l'entreprise. 

La gestion de contenu permet d'assurer la qualite de 
■'information 

La gestion de contenu permet en outre aux informations mises en ligne de 
suivre un circuit de validation qui reduit les risques d'erreur de publication. 
On peut ainsi rejeter un contenu afin qu'il soit corrige puis soumis a nouveau 



a validation. D'autre part, il est toujours possible de commenter un contenu 
afin d'y ajouter des informations complementaires ou d'elargir son contexte. 

D'autres fonctions importantes liees a la qualite de l'information sont la nor- 
malisation des gabarits de pages, le suivi de la validite des documents dans le 
temps, la possibility de retour en arriere, et l'archivage automatique. Ces 
fonctions sont autant de garanties d'une meilleure experience utilisateur, fac- 
teur benefique pour l'audience du site. 

Le gestionnaire de contenu dispose d'une interface utilisateur 
adaptee a son besoin 

Un aspect important des sites web modernes est la maniere dont les fonc- 
tionnalites de presentation et de navigation sont mises en oeuvre. A partir du 
moment ou le site s'adresse a un public large et diversifie, souvent interna- 
tional, la mise en oeuvre de la charte graphique et la gestion de l'interface 
utilisateur ne peuvent plus etre prises a la legere. Un nouveau metier, celui de 
« specialiste de l'ergonomie web », s'est meme developpe. 

Un investissement pour I'avenir 

La plate-forme technique de Plone est saine, avec une separation 
« Presentation/Structure/Logique/Donnees » qui permet de changer le 
comportement visuel du site simplement avec les parametres CSS (voir 
chapitre 5), et avec un outil integre de migration qui gere les changements 
techniques necessaires lors d'une mise a jour. 

Avantages de Plone pour les developpeurs 

Un socle technique sur lequel batir des applications « metier » 

Le developpeur peut jouer sur plusieurs niveaux d'integration de Zope, qui 
lui donnent une flexibilite importante. II peut : 

• integrer ou etendre des types de contenu deja disponibles, 

• developper ses propres types de contenu. C'est generalement necessaire 
des que Ton doit fournir des « objets metier », 

• batir de la logique applicative au sein de la skin pour apporter des fonc- 
tionnalites supplementaires au site, 

• developper son propre composant ou Tool, 

• integrer des donnees externes (via des connecteurs aux SGBDR, des 
scripts de connexion a des serveurs externes, etc.). 



Principaux apports de Plone 2 

• Integration complete des composants du CMF et des produits additionnels tels que 
GroupUserFolder avec pour objectif une infrastructure plus robuste et extensible. 

• Couche de presentation et d'integration graphique offrant des sites fortement ergonomi- 
ques et conformes aux standards d'accessibilite (W3C AAA, Section 508). 

• Plone Control Panel : interface d'administration extensible grace a la technologie des 
« configlets ». 

• Nouveaux types de contenu bases sur la technologie Archetypes. 

• Riche bibliotheque de composants maintenus dans le cadre du projet Sourceforge 
Collective (http://collective.sourceforge.net). 

• Meilleurs outils 11 8N. 

• Amelioration de la recherche grace a I'utilisation d'index plus performants (ZCTextlndex, 
TextlndexNG, Datelndex, DateRangelndex, Topiclndex, etc). 

Un systeme d'authentification integrant la gestion des groupes 

Le composant GroupUserFolder, developpe par Ingeniweb, a ete integre a 
Plone 2 pour permettre l'authentification a partir d'une source d'utilisateurs 
geree dans Zope ou sur un serveur externe (LDAP, Active Directory, ou base 
SQL), et la gestion de groupes d'utilisateurs. Cette gestion des groupes est 
essentielle pour la mise en oeuvre d'un portail collaboratif puisqu'elle facilite 
la distribution des droits et permet la gestion d'espaces collaboratifs. 

Une librairie de composants « plug-ins » 

La communaute CMF/Plone, via son projet Collective sur Sourceforge.net, 
fournit un nombre important et sans-cesse croissant de composants pour 
repondre a differents besoins. Le developpeur n'a pas besoin de reinventer la 
roue. II a toutes les chances de trouver au sein du Collective un composant 
qui reponde a son besoin (au moins en partie). II peut rapidement le tester, 
l'integrer et/ou contribuer a le faire evoluer vers une API assez robuste pour 
que toute la communaute puisse se reposer sur ce composant a l'avenir. C'est 
le cas des composants/outils tels que GroupUserFolder et Epoz, qui sont 
aujourd'hui des composants fournis en standard dans Plone 2. 

Des composants parametrables 

Les composants sont egalement assez generiques pour couvrir plusieurs cas 
d'utilisation ou configurations de deploiement. Pour atteindre ce niveau flexibi- 
lite sans sacrifier la qualite logicielle, les composants proposent pour la plupart 
des options de parametrage disponibles sur les objets qu'ils gerent ou sur une 
fiche de proprietes (objet de type PropertyManager) au sein du composant 
portal_properties. Certaines options s'appuient sur le langage TALES pour 
permettre un parametrage dynamique (exemple des actions de portal _actions). 



Et aussi.. 



CULTURE Plone, c'est aussi 
un projet bien organise 

Des equipes : 

• Developpement 

• Gestion des versions publiees et des 
« installeurs » (outils d'installation) 

• i18n (traductions) 

• Documentation 

Des processus et des pratiques : 

• Plone Improvement Proposal (PLIP) 

• Obligation d'ecrire des tests unitaires 

• Sessions de sprint 
Des outils : 

• Collecteur de bogues 

• Site web 

• Referentiel de code base sur CVS (Source- 
forge) 

• ZopeTestCase et CMFTestCase 



La solution Plone integre progressivement les autres outils qui font la force 
de Zope, tels que : 

• le moteur d'indexation, le ZCatalog, et les nouveaux types d'index intro- 
duits par les developpeurs de la communaute (Topiclndex, Textln- 
dexNG, FieldedTextlndex, etc.) ; 

• les solutions de gestion de la memoire cache (Cache Managers) ; 

• l'outil de clustering applicatif, Zope Enterprise Objects (ZEO), integre 
en standard depuis Zope 2.7 ; 

• la technologie Adaptable Persistent Engine (APE), qui complete la base de 
donnees objet de Zope pour permettre le mapping relationnel-objet. 

En resume... 

Plone s'avere la solution ideale dans le monde Zope pour des projets de por- 
tail collaboratif ou d'intranet/extranet. Cette technologie amene avec elle la 
puissance de Python et Zope, et est completement adaptee aux approches de 
developpement pragmatique. Les responsables d'un projet peuvent rapide- 
ment mettre en oeuvre le socle technique du site, puis y integrer la charte 
graphique, le contenu, et les services complementaires developpes sur 
mesure, ceci de maniere incrementale. 

Nous allons vous montrer dans les chapitres qui suivent comment elaborer et 
mettre en oeuvre votre projet de portail ou de systeme de gestion de contenu 
avec Plone. 
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Presentation 
de I'etude de cas 




• 

Nous allons rentrer dans le vif du sujet en abordant le site qui va servir de support 
a I'etude de cas. Nous verrons que cette etude est articulee autour de la realisa- 
tion d'un site intranet d'entreprise, mettant en ceuvre les fonctionnalites de 
gestion de contenu de Plone. 



B.A.-BA Intranet/extranet 



Un intranet est un site web dont I'acces est reserve 
aux actifs d'une collectivite (entreprise, adminis- 
tration, communaute, etc.). En termes de reseau, 
un intranet est generalement visible uniquement 
depuis I'interieur de I'etablissement. 
Un extranet est un intranet auquel on accede 
depuis le reseau Internet, apres s'etre identifie par 
un identifiant et un mot de passe. II n'est pas rare 
qu'un extranet soit egalement ouvert aux parte- 
naires, clients ou fournisseurs de I'entreprise, selon 
les cas ou les besoins. 



Un projet d intranet d'entreprise 

Cet ouvrage est concu autour de l'analyse d'un cas precis : l'intranet de 
I'entreprise Active « Societe Geniale ». La « Societe Geniale » est une PME 
specialised dans la conception, la production, la commercialisation et le ser- 
vice apres-vente de farces et attrapes. Cet intranet est notamment disponible 
pour les differents services qui composent la societe : 

• Administration, 

• Marketing, 

• Commercial, 

• Production, 

• Service Apres-Vente (SAV), 

• Direction Generale. 

Pour simplifier l'etude, nous limiterons notre analyse a trois populations : 

• Marketing, 

• Service Apres-Vente, 

• Direction Generale. 



Les besoins 



QUALITE Les services d'un intranet moderne 



Gestion des utilisateurs 

Securite basee sur les roles 

Base documentaire (Diffusion de documents, 

d'informations et d'actualites de la societe a 

I'ensemble des salaries) 

Rubriques pour I'acces aise au contenu 

Acces restreint a certains contenus en fonction 

du profil 

Workflow : circuits de validation de publication 
Agenda partage 
Moteur de recherche 

Integration de fichiers bureautiques (Word, 
Excel, PDF, etc.) 

Espace de contenu personnel pour chaque sala- 
ried 

Espaces de travail collaboratif 



Gestion des utilisateurs 

Les utilisateurs s'authentifient aupres du site intranet grace a leur identifiant 
et leur mot de passe. lis sont reunis en groupes qui peuvent etre caiques sur 
l'organisation de I'entreprise, chaque personne etant rattachee a un ou plu- 
sieurs service(s) donne(s). 

Les comptes utilisateurs peuvent etre crees par l'administrateur du site ou 
fournis par l'integration d'une source externe de comptes utilisateurs comme 
un annuaire LDAP. 

Securite basee sur les roles 

Les roles regroupent des permissions techniques qui autorisent I'acces au 
contenu de l'intranet ainsi que des actions au sein de l'intranet. Les exemples 
de permissions necessaires aux acteurs ou membres du site sont : 

• ajouter du contenu ; 

• modifier le contenu ; 

• ajouter des dossiers ; 

• modifier les metadonnees des elements. 

Au depart, les membres de l'equipe qui s'occupe du parametrage et de la 
maintenance du site possedent le role d'administrateur. lis ont ensuite a 
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s'assurer que les roles correspondant aux differents profils d'utilisateurs sont 
parametres et affectes aux utilisateurs. 



//, Roles, utilisateurs, groupes 

Quelle difference faire entre role, utilisateur et groupe ? La reponse est parfois subtile, 
essayons d'apporter quelques eclaircissements. 

Un utilisateur est la representation informatique d'une personne physique. On utilise gene- 
ralement un derive de son nom pour construire son identifiant (ex : jdupont pour Jean 
Dupont). 

Un role est generalement la representation informatique d'une fonction dans I'entreprise. 
Par exemple, le role « Photographe » sur un site editorial identifie la fonction de photogra- 
phe (si, si, promis). Les utilisateurs sont porteurs de zero, un ou plusieurs role(s). Ainsi, 
notre utilisateur jdupont, porteur du role « Photographe » aura la possibility d'ajouter des 
photographies sur le site. 

Un groupe est la representation informatique d'un groupement d'utilisateurs (ou de grou- 
pes). Ces utilisateurs sont reunis dans un groupe parce qu'ils partagent un point commun, 
par exemple I'appartenance a un meme service de I'entreprise. Ainsi, le groupe 
« Marketing » va regrouper tous les membres du service eponyme. Un utilisateur peut 
appartenir a zero, un ou plusieurs groupe(s). Ainsi, jdupont peut par exemple etre membre 
des groupes « Marketing », « Direction » et « Equipe de Foot N°1 ». Utiliser les groupes est 
done une facon pratique de distribuer des droits sur le site ou simplement de classer les uti- 
lisateurs. 



Base documentaire 

L'objectif principal du site est de permettre la diffusion d'informations aux 
salaries de la societe. La production de cette information n'est pas reservee a 
une elite informatique, mais ouverte a tous, avec, pour certaines informa- 
tions, un circuit de validation avant publication. 

Les types d'informations a gerer sont : 

• actualites ; 

• articles ; 

* evenements ; 

* liens. 

Rubriques d'acces au contenu 

Le site doit fournir des rubriques qui permettent un acces rapide a l'infor- 
mation. Une rubrique est un espace ou sont agregees toutes les informations 
publiees repondant a un critere donne. On retrouve generalement des rubri- 
ques telles que « Actualites », « Produits » et « Liens ». 



PLONE Les rubriques 

Dans Plone, une rubrique est un objet nomme 
Topi c qui agrege les resultats d'une recherche sur 
le ZCatalog a partir d'un critere que le concepteur 
du site definit. Ce type de rubrique est une solu- 
tion efficace pour organiser I'acces a I'information 
dans un site a haut volume. Du fait de I'utilisation 
du ZCatalog, I'affichage de la page d'une rubrique 
est rapide. D'autre part, un meme contenu peut 
apparaitre dans des rubriques differentes. 
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PLONE Les rubriques a acces restreint 

Pour parvenir a restreindre I'acces a une rubrique, 
I'utilisation d'un etat de workflow (par exemple 
publishedRestricted ) avec une politique de 
securite locale est une excellente strategie avec 
Plone. 



Circuits de validation de publication (workflow) 

Tous les salaries peuvent, une fois authentifies grace a leur identifiant et leur 
mot de passe, proposer du contenu dans le site, dans les rubriques pour les- 
quelles ils auront ete habilites a le faire. Un circuit de validation permet aux 
responsables de rubriques de valider ou de refuser la publication d'un con- 
tenu propose. 

Acces restreint a certains contenus en fonction du profil 

Certaines informations doivent etre a acces restreint. Dans notre cas, les 
dossiers contenant les informations strategiques ou sensibles de la Direction 
Generate seront prives et leur acces ne sera autorise qu'aux utilisateurs mem- 
bres de ce service. 

Agenda partage 

Les evenements de la societe sont consignes dans un agenda partage par 
tous. La publication d'un evenement dans l'agenda est egalement soumise a 
un circuit de validation. 



Portlets 



Le terme portlet, ou « boite laterale », designe les 
conteneurs d'informations que I'utilisateur (ou 
I'administrateur) peut disposer dans les colonnes 
gauche et droite du site. Ce terme nous vient tout 
droit du monde Java. Alors que les termes applet 
(« petite application ») et servlet (« petit serveur ») 
etaient tres utilises pour designer respectivement 
une mini-application embarquee dans un naviga- 
teur web et un mini-serveur java responsable 
d'une tache atomique, le terme portlet (« petit 
portail ») s'est vite impose pour designer ces boT- 
tes qui composent les portails... 



Moteur de recherche 

Le moteur de recherche permet de retrouver les informations disponibles sur 
l'intranet, en ne presentant a I'utilisateur que les contenus qu'il est habilite a 
voir. Les resultats de la recherche sont affiches sur une page dynamique dont 
l'ergonomie est tres travaillee. Ces resultats doivent pouvoir etre facilement 
parcourus et reclasses. 

Ce meme moteur de recherche sera egalement utilise pour afficher dynami- 
quement (dans une boite laterale, ou « portlet ») les actualites recentes du 
site et les informations relatives a la rubrique ou au document que l'inter- 
naute est en train de consulter. 

Integration des fichiers bureautiques (Word, Excel, PDF, etc.) 

II est de notoriete publique que 90 % de l'information d'une entreprise est 
stockee dans des fichiers bureautiques, utilisant generalement la suite 
bureautique Microsoft Office™ (et de plus en plus souvent Open Office, 
son concurrent issu du logiciel libre). Les utilisateurs devront done pouvoir 
ajouter facilement ces contenus dans le site. Le contenu de ces fichiers devra 
etre accessible par le moteur de recherche. Si un utilisateur sollicite le 
moteur de recherche avec un mot contenu dans un fichier PDF publie sur le 
site, ce fichier sera retrouve immediatement, quel que soit l'endroit ou ce 
mot est ecrit dans le fichier PDF. 
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Espace personnel pour chaque salarie 

Chaque utilisateur dispose d'un espace personnel dans lequel il peut mettre 
en place ses propres fichiers, ou bien travailler ses contributions avant 
demande de publication. 

Espaces de travail collaboratif 

Chaque groupe de travail dispose d'un espace commun a tous ses membres. 
Ceci permet a des utilisateurs de travailler ensemble a 1' elaboration d'un 
document, avant de decider d'en publier une version definitive. 



Presentation du site 

Nous avons assez bavarde ! Parcourons ensemble ce bel intranet. 

Page d'accueil 

Pour se connecter au site, l'utilisateur pointe son navigateur sur : http://intranet. 

On distingue cinq grandes parties sur cette premiere page qui expose toutes 
les fonctionnalites et interactions importantes aux utilisateurs arrivant sur le 
site. Nous les detaillons ci-dessous. 

La barre de haut de page 

On y retrouve principalement le logo de l'entreprise, des onglets represen- 
tant les liens vers les rubriques importantes du site, et les liens d' actions per- 
sonnelles (specifiques au profil de l'utilisateur). 




Figure 2-1 Haut de page 



La barre de gauche 

On y retrouve par exemple l'arbre de navigation et la boite permettant de 
s'identifier. En particulier, la boite de navigation permet de savoir ou Ton se 
trouve dans le site et de naviguer rapidement en cliquant directement sur les 
sections voulues. 



Figure 2-2 Barre de gauche 
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Figure 2-3 Barre de droite 



La partie centrale 

C'est la partie qui diffuse le contenu a proprement parler de la page 
d'accueil. Elle combine du contenu statique, fourni par un document que le 
webmestre peut facilement modifier, et du contenu dynamique pour plus 
d'efficacite. La zone de contenu dynamique agrege les dix documents et arti- 
cles recemment publies au sein du site en les classant par ordre chronolo- 
gique inverse. 

La barre de droite 

On y retrouve des elements apportant des services supplementaires aux 
membres de l'intranet, typiquement la boite de recherche utilisant des 
moteurs de recherche Internet (Google, Pages Jaunes, Societes.com, etc.), la 
boite des dernieres actualites, et l'agenda donnant acces aux evenements 
publies sur le site. 

La barre de bas de page 

Elle est reservee a des informations de copyright et a d'autres interactions 
importantes que Ton veut exposer a l'utilisateur (lien de retour en debut de 
page, acces au plan du site, etc.). 



Copyright © 2000- 2004 par Alexander Limi, Alan Runyan, Vidar Andersen. 



Figure 2-4 Bas de page 



Principales rubriques et espaces collaboratifs 
Rubriques 

Les rubriques constituent le principal mode d'acces a l'information au sein 
du site. 

La rubrique Actualites regroupe les articles d'actualite et de revue de presse 
publies par l'equipe Marketing. 

Documentation regroupe les documents sur les processus et precedes techni- 
ques relatifs a l'activite de l'entreprise. 

On trouve sur Produits des articles publies par l'equipe Marketing, diffusant 
notamment les fiches « produits » de la societe. 

Evenements regroupe les annonces d'evenements relatifs a l'activite de 
l'entreprise (conferences, ateliers, journees d'action commerciale, etc.) 

Partenaires regroupe des liens annotes vers les sites partenaires ou affilies, ou 
les sites de reference. 
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■a 

Espaces collaboratifs 1 

En dehors des rubriques d'information, des espaces collaboratifs peuvent ^ 

etre crees pour permettre a un groupe de collaborateurs de 1'entreprise de § 

travailler ensemble sur une etude ou un projet donne, a caractere confiden- | 

tiel (ou non). ^ 

Ces espaces sont a acces restreint au groupe. Us peuvent etre permanents ou 
temporaires, l'administrateur etant charge de les parametrer selon le besoin, 
et eventuellement d'archiver leur contenu lorsque cela est necessaire. 

Workflows de publication 

Le workflow de publication mis en oeuvre par le systeme de gestion de con- 
tenu definit les etats par lesquels le contenu transite, selon la politique edito- 
riale et/ou de collaboration du site, depuis sa creation jusqu'a sa destruction. 

Le workflow de publication de documents (et d'articles) est principalement 
compose des etats suivants : 

• Prive- C'est l'etat initial d'un document en cours de redaction. 

• En attente de moderation - C'est l'etat intermediate par lequel doit passer 
le contenu devant etre publie. Le contenu attend dans cet etat d'etre 
valide par un moderateur (concretement, d'etre « publie »). 

• Publie - C'est l'etat dans lequel le contenu est publiquement accessible 
par toutes les personnes de 1'entreprise accedant a l'intranet. 

II existe un workflow simplifie, pour les dossiers (utilises comme conteneurs 
des documents). Le workflow des dossiers est compose uniquement des etats 
prive 'et -publie, l'etat prive etant l'etat initial. 



Retirer 




Figure 2-5 Schema d'un exemple de workflow pour les documents 



19 



B.A.-BA Delegation de droits 

La delegation de droits permet a un utilisateur, 
comme dans la vraie vie (enfin, souvent), de dele- 
guer (preter) ses droits a un autre utilisateur. Ainsi, 
en cas d'absence de I'indispensable Directeur Mar- 
keting, son jeune bras droit pourra le remplacer 
pendant cette periode. Plutot que de donner son 
identifiant et son mot de passe a cet utilisateur, le 
directeur va simplement lui deleguer les droits de 
moderation du contenu qu'il aura dans telle ou 
telle rubrique. 

II est interessant de noter qu'un utilisateur ne peut 
donner (ou deleguer) plus de droits qu'il n'en a lui- 
meme. 



Contribution de contenu 

Le contenu d'un dossier (ou d'un espace) peut etre redige et maintenu par les 
membres du site ayant des droits de contribution dans ce dossier. Ces droits 
sont done attribues localement via l'onglet Partage accessible dans le con- 
texte de chaque dossier (pour les utilisateurs ayant les bons droits). C'est une 
solution efficace pour la gestion deleguee du contenu. 

Pour contribuer, vous devez d'abord acceder a un dossier ou vous avez l'auto- 
risation de proposer du contenu. Dans un tel dossier, vous voyez apparaitre 
les onglets de gestion avancee tels que Contenu, Partage, ainsi qu'un lien per- 
mettant d'ajouter votre element de contenu, et un autre permettant de 
changer t'etat du dossier si besoin. 
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Figure 2-6 Vue du contenu d'un dossier 



OUTILS Gerer un projet Plone 



Collecte des specifications : Wiki 

Tests unitaires : ZopeTestCase et CMFTestCase 

Moderation : UML 

Gestion d'un referentiel de code source : CVS 



Points de methodologie 



Identification des acteurs 

Un acteur represente un role joue par une entite externe (utilisateur, autre 
systeme informatique) qui interagit directement avec le systeme a realiser. 
Dans notre cas de figure et pour des raisons de simplification, il n'y a que des 
acteurs humains. 

Les acteurs du site intranet sont les suivants : 

• Le membre : toute personne enregistree dans la base d'utilisateurs du 
site, et qui peut consulter tout le contenu publie. De plus, le membre dis- 
pose d'un dossier personnel oil il peut produire et eventuellement publier 
du contenu personnel. Pour faire simple, on pourra dire que les membres 
sont les salaries de la societe. 
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QUALITE Pratiquer l'« extreme Programming » 

Cette methodologie de developpement (terme inexact, mais pratique pour situer le debat), 
preconise de nouvelles dispositions de travail sur un projet de developpement logiciel. 
Comme toute methode de developpement, I'eXtreme Programming (XP) propose un cadre 
pour I'ensemble des aspects du projet logiciel, depuis I'analyse des besoins jusqu'aux tests, 
en passant par la conception. Mais a la difference de processus predictifs, recourant gene- 
ralement a UML, XP ne se fonde pas sur la definition exhaustive et precoce des besoins ; 
elle parie plutot, a partir d'un ensemble de regies strides, sur la souplesse et la mise en 
valeur du « capital humain ». 

La programmation objet et la gestion de projet comme disciplines collectives : tout en met- 
tant I'accent sur les bonnes pratiques de programmation, XP preconise un deroulement par 
iterations courtes et gere collectivement. II en decoule une redefinition de la relation entre 
clients et fournisseurs, avec de surprenants resultats en termes de qualite de code et de 
delais. 

Plus d'informations : 

HI L'Extreme Programming, avec deux etudes de cas, de Jean-Louis Benard, Laurent Bossavit, 
Regis Medina, Dominic Williams aux Editions Eyrolles. 



• Le contributeur : personne qui fait partie de l'equipe redactionnelle de 
l'intranet ; il est autorise a ajouter et modifier du contenu dans une (ou 
plusieurs parties) du site a caractere public (hors de son dossier person- 
nel). 

• Le moderateur : personne qui relit et valide la publication de contenus 
qui lui sont soumis, ou les retourne aux auteurs pour correction avant 
d'accepter de les publier. 

• Le webmestre : personne qui a en charge la maintenance du site, notam- 
ment la creation des dossiers qui structurent le site et la gestion des 
comptes utilisateurs et de leurs habilitations. 

Identification des cas d'utilisation 

Un cas d'utilisation (ou use case) represente un ensemble de sequences 
d'actions qui sont realisees par le systeme informatique (ici le systeme de 
gestion de contenu du site) et qui produisent un resultat observable et utile 
pour un acteur donne. 

A titre d'exemple, nous presentons ici les deux principaux cas d'utilisation de 
la contribution d'articles au sein du site. 

Creation et edition d'un article 

Acteur(s) : Contributeur 
Preconditions : 

• Le contributeur est authentifie par le systeme. 

• Le contributeur se trouve dans un dossier ou espace ou il a les droits requis. 



Metadonnees 



Le titre et la description sont essentiels pour la 
decouverte (via le moteur de recherche par exem- 
ple) et la consultation de votre article. Ce sont les 
premieres metadonnees de votre contenu. On y 
ajoutera par exemple I'auteur ou la date de publi- 
cation du contenu. 



Alternative 



Si le moderateur ne souhaite pas valider I'article, il 
choisit Taction de le rejeter ; I'article revient dans 
I'etat « prive » et le contributeur peut le remanier. 



Scenario : 

• Via un bouton ou lien d'action, le contributeur accede au formulaire de 
creation de I'article. 

• Le contributeur complete les champs du formulaire avec le contenu tex- 
tuel de son article et valide. 

• L' article est cree dans son etat initial, letat prive. 

• Le contributeur peut continuer a le modifier. En passant par les onglets 
d'extension de I'article prevus par le systeme, il peut lui associer des 
mots-cles, des photos, et/ou des fichiers bureautiques en piece jointe. 

Publication d'un article 

Acteur(s) : Contributeur, Moderateur 
Preconditions : 

• Les acteurs sont authentifies par le systeme. 

• Larticle se trouve dans letat « prive ». 
Scenario : 

• Via un bouton ou lien d'action disponible dans le contexte de I'article, le 
contributeur soumet celui-ci pour la publication. 

• Lorsqu'il se connecte, le moderateur concerne par I'article, voit apparai- 
tre ce dernier dans la liste des elements en attente de moderation. II con- 
suite I'article et, apres relecture, s'il est d'accord pour le publier, il 
actionne le bouton (ou le lien) permettant de passer I'article a letat 
« publie ». 



Strategie de stockage du contenu 

Nous devons trouver la meilleure solution de stockage des articles et des 
documents. La base de donnees objet de Zope fournit une solution perfor- 
mante pour stacker chaque article et y acceder soit directement via son 
chemin, soit, plus efficacement, via le moteur d'indexation du site. Les 
informations peuvent ensuite etre agregees sur les pages des rubriques. 
Meme pour des gros volumes (plusieurs giga-octets), la base objet de Zope 
est parfaitement adaptee, ses performances restant excellentes. 

II est conseille d'utiliser une arborescence de stockage calquee sur l'organisa- 
tion des gestionnaires de contenu, de maniere a permettre la gestion dele- 
guee du contenu. 
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Typiquement, dans notre cas, on aurait l'organisation suivante : 



[Contenu] ^-Dossier racine de la base documentaire 
Marketing 

actus 

produits 

liens 

SAV 

actus 

procedures 
solutions 
liens 
Direction 

procedures 

memos 

gestion 



En resume... 

Maintenant que nous avons fait le tour des besoins d'un projet d'intranet 
« type », lancons-nous dans la mise en oeuvre. Apres l'installation du serveur 
de developpement, nous allons voir, au fil des chapitres suivants, comment 
Plone apporte une solution a la fois simple et elegante aux besoins fonction- 
nels de ce type de projet. 



retaliation de 
Zope et de Plone 



Plate-forme | Instance Zope | Modules | Composants | Produits | Services | 



SOMMAIRE 

► Composantes d'une plate- 
forme Plone 

► Installation du serveur Zope 

Installation des produits et 
modules 

Demarrage et acces au serveur 

► Conclusion 

MOTS-CLES 

► Plate-forme 

► Instance Zope 
Modules 

► Composants 
Produits 
Services 



■ Plone Controller - [Plone Status] 



: Plone 
Q Ports 
9 Status 
.3, Emergency User 
d About 



Status Plone is now stopped 
Start 



Plone is configured to run as a service 

View Plone | Manage Root | 



Dans ce chapitre, nous allons installer les differents composants logiciels necessai- 
res a I'infrastructure et a la mise en oeuvre du site intranet, non sans rappeler 
quelle est I'infrastructure de Plone. 



RAPPEL Publicateur d'objets de Zope 

Chaque fois que vous invoquez une URL, Zope 
vous sert un objet grace a un module nomme 
ZPublisher, qui joue le role d'ORB {Object 
Request Broker). 



Composantes d'une plate-forme Plone 

Rappelons que Plone est une plate-forme de gestion de contenu qui s'appuie 
sur le serveur d'application Zope. Le coeur de Zope est un systeme de publi- 
cation d'objets nomme ZPublisher. D'autres services de « bas niveau » sont 
offerts par le serveur: des objets de contenu simples (Folder, Image, File, 
etc.), des objets qui executent du code (DTML Method, Page Template, Script 
Python), le systeme de securite, le moteur d'indexation, etc. Plone n'est en 
fait que la « surcouche » qui facilite la mise en ceuvre d' applications de ges- 
tion de contenu. Nous presentons ci-dessous les composantes de cette sur- 
couche logicielle. 



[.'infrastructure de Plone 

L'infrastructure de Plone est fournie par les produits CMF auxquels contri- 
buent Zope Corporation et les principaux acteurs de la communaute CMF/ 
Plone. Decouvrons-les ci-dessous. 



Archive des produits de la couche CMF 

Le CMF est disponible (independamment de Plone) 
comme un ensemble de produits qui fournissent la 
base de l'infrastructure : CMFCore, CMFDefault, 
CMFCalendar, CMFTopic, et DCWorkflow. 

► http://www.zope.org/Products 



Le produit CMFPIone 

C'est le produit central qui apporte les fonctionnalites du systeme de gestion 
de contenu Plone. Tous les autres produits sont soit des dependances, soit 
des options complementaires. 

La base de ('infrastructure 
CMFCore 

C'est le produit qui fournit le cceur de l'architecture de CMF et ses classes 
d'objets techniques. 



OUTILS Archetypes 



Ce paquetage est presente plus loin dans ce chapi- 
tre. Concernant son utilisation par le developpeur, 
reportez-vous au chapitre 6. 
La reference des champs et des widgets Archetypes 
est donnee dans I'Annexe 3 de cet ouvrage. 



CMFDefault 

C'est le produit qui fournit la premiere implementation par defaut d'un por- 
tail base sur le CMF. Plone s'inspire des choix techniques de CMFDefault 
et utilise certains de ses composants via l'heritage. 



DEPENDANCE CMFPIone et CMFDefault 

I! est prevu qu'une future version de Plone ne depende plus de CMFDefault. Typiquement, 
le produit tierce partie CMFPIoneTypes, actuellement en version beta, devrait permettre de 
remplacer les types de contenu de CMFDefault par de nouveaux types (Plone Document, 
Plone News Item, etc.) construits sur une base CMFPIone/Archetypes. Des outils seraient 
alors fournis pour permettre aux utilisateurs de migrer leur contenu existant. 
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CMFTopic 

C'est le produit qui fournit le type de contenu Topi c permettant, dans les 
sites a haut volume de contenu, de creer des vues transversales (ou « nitres » 
ou « themes ») basees sur le moteur de recherche. II s'agit d'un puissant com- 
posant CMF. 

CMFCalendar 

C'est le produit qui fournit le type de contenu Event permettant de creer des 
fiches « Evenement ». 

DCWorkflow 

Developpe par Shane Hathaway de Zope Corp., DCWorkflow est le pro- 
duit Zope qui fournit le moteur de workflow des applications CMF. Pour en 
savoir plus sur le parametrage des workflows avec DCWorkflow, reportez- 
vous au chapitre 6 « Personnalisation fonctionnelle ». 

Les autres dependances de Plone 
CMFQuicklnstallerTool 

C'est le produit qui facilite la configuration des nouveaux composants plug- 
ins CMF que Ton veut integrer dans un site Plone. Ce sont ses services qui 
sont exposes par le Plone Control Panel, accessible via l'interface 
Installation de nouveaux produits. 

CMFActionlcons 

Ce nouveau produit, propose par Tres Seaver, permet d'associer des icones 
aux actions du site. L'interface utilisateur s'appuie sur cet outil pour exposer 
des barres d'actions a base d'icones (les fameuses toolbars). 

CMFFormController 

Ce nouveau produit fournit les mecanismes sur lesquels s'appuie la gestion 
de la validation et des actions associees aux formulaires au sein du site. 

GroupUserFolder 

Developpe par Ingeniweb, GroupUserFolder est un systeme d'authentifica- 
tion de Zope qui permet la gestion des groupes d'utilisateurs. Les comptes 
utilisateurs peuvent provenir de plusieurs sources (le serveur Zope lui-meme, 
un annuaire LDAP, ou une base SQL). GroupUserFolder est integre en 
standard dans Plone depuis la version 2.0 et est complete par des services 
permettant la mise en ceuvre d'applications de groupware. 



SYNTAXE Topic (ou Rubrique en francais) 

Les Topics sont typiquement utilises pour cons- 
truire des rubriques qui agregent des articles ou 
documents correspondant a un critere donne. 



SYNTAXE Event (ou Evenement en francais) 

Le type Event permet de mettre en ceuvre une 
rubrique Agenda simple, sans aucun developpe- 
ment supplemental. 



RAPPEL Qu'appelle-t-on workflow ? 

Le workflow est la discipline ou le concept d'orga- 
nisation des circuits de communication et de vali- 
dation de I'information. 



JARGON Qu'est-ce qu'une action ? 

Une action est I'abstraction dans I'architecture 
CMF qui permet de representor une interaction 
web (entre I'utilisateur et le site) en lui associant 
de la logique applicative. Les actions sont gerees 
grace au composant CMF Actions Tool . Pour 
en savoir plus, reportez-vous au chapitre 5. 



HISTORIQUE Composants portal_form et 
portal form controller 

CMFFormController fournit un nouveau compo- 
sant nomme portal_form_controller, qui 
remplace le composant portal_form de Plone 1. 



► http://sourceforge.net/projects/collective 



27 



Formulator 



► http://sourceforge.net/projects/formulator/ 



Developpe par Maartijn Faassen d'Infrae, Formulator est le produit Zope le 
plus complet pour la problematique de gestion technique des formulaires 
web. 

En ce qui concerne Plone 2.0, les services de Formulator sont maintenant 
remplaces par ceux de CMFFormController, mais le produit est encore 
inclus dans la distribution de Plone. 

BTreeFolder2 

II s'agit du produit qui ajoute a Zope la classe BTree Folder, base technique 
des types de dossiers capables d'avoir des milliers de contenus, comme le 
nouveau type Large Plone Folder introduit dans Plone 2. Les BTree Folders 
stockent leurs sous-objets dans une structure Python de type BTree, pour 
plus de performance. 



Les produits d'extension de Plone 



Les produits de developpement 



DEPENDANCES Archetypes 

Archetypes est ce qu'on appelle un mini- 
framework ; un framework specialise a I'interieur 
du framework CMF. 

Archetypes s'appuie sur deux modules Python 
additionnels inclus dans sa distribution : les modu- 
les generation et validation. Vous devez les 
installer dans le repertoire des modules Python de 
votre serveur, typiquement [Zope] /lib/ 
python, ou dans le repertoire des produits Zope, 
auquel cas ils sont pris en compte en tant que pro- 
duits Zope. 



HISTORIQUE PlacelessTranslationService 
vs TranslationService et Localizer 



La solution PlacelessTranslationService (PTS) rem- 
place le couple TranslationService et Localizer uti- 
lise pour internationaliser I'interface des sites avec 
Plone 1. 



Archetypes 

II s'agit d'une suite logicielle ou framework d'aide au developpement de types 
de contenu CMF. Concretement, Archetypes permet au developpeur de 
definir un « schema » et, a partir de celui-ci, produit le code necessaire a la 
logique du type de contenu. Beaucoup de composants de la communaute 
Plone s'appuient sur cette technologie et elle devrait devenir la base de tous 
les types d'objets « metiers » a l'avenir. 

PortalTransforms 

Complementaire de l'outil Archetypes, ce composant permet d'effectuer des 
transformations de formats pour les attributs textuels (Texte structure, HTML, 
RTF, Word, etc.) definis pour un type de contenu. 

Les extensions pour le support multilingue 

PlacelessTranslationService 

PlacelessTranslationService (PTS) fournit le moteur de l'internationalisa- 
tion (il8n) des pages d'un site construit avec Plone 2. 
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PloneLanguageTool 

Complementaire de PTS, ce produit rend parametrable la negociation que 
doit faire le navigateur avec le serveur pour afficher les pages d'un site multi- 
lingue dans la langue que souhaite l'utilisateur. Les parametres utilises dans 
cette negociation sont par exemple : 

• la langue par defaut du navigateur, 

• les langues utilisees pour le site, et celle par defaut, 

• la langue explicitement demandee par l'internaute via un parametre pre- 
sent dans l'URL ou dans un cookie. 

H8NLayer 

I18NLayer est le produit CMF/Plone/ Archetypes permettant de mettre en 
ceuvre du contenu multilingue de maniere aisee. Son principe est d'encap- 
suler plusieurs versions du contenu (par exemple, un document traduit en 
plusieurs langues) au sein d'un objet conteneur. 

Les produits de la gestion editoriale 
PloneArticle 

PloneArticle est un composant Plone qui fournit un type de contenu pour la 
publication d'articles et/ou de documents integrant des images et des pieces 
jointes. C'est la solution ideale pour les sites fortement orientes « Contenu 
editorial » ou pour les intranets avec un besoin d'integration des documents 
bureautiques de l'entreprise. La recherche full text s'applique au contenu des 
fichiers bureautiques integres en pieces jointes. 



CULTURE i18n ? 



Le monde de I'informatique utilise bien souvent 
des barbarismes : i18n en est un parfait exemple. 
11 8n signifie « internationalisation », et se note 
i18n car il y a 18 lettres entre le « i » et le « n «... 
La localisation se note 11 On 
C'est sur : les informaticiens sont des poetes ! 



PloneExFile 

Ce composant fournit un type de contenu pour la gestion de fichiers bureau- 
tiques dans un site Plone. II vous permet de stacker le contenu d'un fichier 
de votre machine en tant qu'objet de contenu au sein du site Plone. Lobjet 
est stocke dans la base de donnees de Zope et est publie selon le workflow. 
Les utilisateurs peuvent telecharger le fichier en piece jointe a tout moment. 
Ainsi, vous pouvez beneficier de la recherche full text. 



DEPENDANCES ZAttachmentAttribute et ZAAPIugins 

ZAttachmentAttribute est une extension Zope qui fournit la couche technique a la fonctionna- 
lite d'association de pieces jointes aux documents d'un site fait en Zope. Ce produit est com- 
plete par le composant ZAAPIugins qui fournit a un site Plone des elements d'interface gra- 
phique et des outils de gestion de formats textuels ou multimedias pour les pieces jointes. 
Ces deux produits servent de base aux composants PloneExFile et PloneArticle pour per- 
mettre d'integrer des fichiers bureautiques aux documents ou articles. 



ALTERNATIVES 

Autres options que vous pouvez installer 

Editeurs de texte : 

• CMFVisualEditor 

• Epoz 

Outils d'aide au developpement : 

• External Editor (pour I'edition de scripts et tem- 
plates) 

• ZopeTestCase & CMFTestCase 
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PLATE-FORME MS-Windows, Linux ou Unix ? 



Zope fonctionne indifferemment sous MS- 
Windows, Unix (Solaris, freeBSD, MacOSX) ou 
Linux (Red Hat, Debian...). 



TELECHARGEMENTS 



Zope est telechargeable a partir de : 

► http://www.zope.org/Products/Zope 

Toutes les dependances de Plone 2 (y compris 
Archetypes) sont livrees dans la meme archive 
telechargeable a partir de : 

► http://www.plone.org/download 

► http://sf.net/projects/plone 



Installation multi-instances 



[.'installation dite « multi-instances » permet de 
mutualiser plusieurs instances de serveur « Zope/ 
Plone » sur le meme logiciel Zope (celui-ci installe 
dans le dossier C:\zope\zope27 par exemple, 
represents par la variable d'environnement 
SOFTWARE_HOME). En pratique, cela facilite la 
maintenance de plusieurs environnements de 
developpement Zope sur la meme machine. Typi- 
quement, vous pouvez avoir plusieurs instances de 
serveur (PloneDev, PloneTest, etc.) et cela 
vous permet d'etre plus reactif et productif. 



Installation du serveur Zope 

Depuis la version 2.7, Zope dispose d'une nouvelle procedure d'installation. 
Elle est a la fois plus simple et plus flexible. Un executable est fourni pour 
une installation rapide sur plate-forme Linux ou MS-Windows. 



POUR LES PRESSES Utiliser un installeur « tout en un » 

Si vous etes presse, vous pouvez telecharger un installeur permettant d'installer Zope et 
tous les modules additionnels pour Plone (y compris Archetypes) a partir de Plone.org. Un 
installeur de ce type est fourni pour les plates-formes MS-Windows et MacOS X. 



Sous MS-Windows 

Installation du logiciel et de I'instance Zope 

Creez votre dossier de travail (C:\zope par exemple), puis lancez le pro- 
gramme d'installation via l'executable fourni sur Zope.org (par exemple, 
Zope-2.7-win32-x86.exe pour la version 2.7). L'installeur vous demande de 
choisir le chemin sous lequel vous voulez installer le logiciel Zope. Vous 
choisissez par exemple le repertoire C:\zope\zope27. 



, Setup - Zope 2.7.0 



Select Destination Location 

Where should Zope 2.7.0 be installed? 



.Jfljxl 



Setup will install Zope 2.7.0 into the following folder. To continue, click Next. 



C:\zope\Zope-27.0 


Browse « 




*CA 




' 1 Documents and Settings 






l_J MinGW 






' 1 My Music 






LJ My Web Sites 






' 1 Program Files 






!_J Python23 




d 


Pi WINNT 




r~i Disque local (C:) 


d 



At least 28,7 MB of free disk space is required. 



< Back | Ne«t> Cancel | 

Figure 3-1 Choix du chemin d'installation du logiciel 

L'installeur vous demande ensuite de choisir le repertoire dans lequel seront 
installes les programmes et donnees de la premiere instance de serveur Zope. 
Vous pouvez choisir par exemple C:\zope\instances\P~loneDev. 

Le dernier ecran de configuration vous demande de choisir le mot de passe 
du compte d'administration initial nomme admin. Apres la validation de cet 
ecran, le programme d'installation copie les differents fichiers a l'emplace- 
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II I II Ih^^^W^^^^M I I I 

Instance Setup 

Select where Zope instance files should be installed 



Select the folder to which you would like Setup to install Zope "instance" files, then 
click Next. 

| C:\zopeSinstances\PloneDev Browse » [ 



< Back Next> Cancel 



Figure 3-2 Choix du chemin d'installation de I'instance 



ment prevu, compile les programmes Python qui doivent l'etre et fait le 
parametrage initial de I'instance du serveur Zope (initialisation de la base de 
donnees objet stockee dans le fichier C:\zope\instances\PloneDev\var\ 
Data.fs, creation du compte d'administration admin, etc.). 

Demarrage du serveur 

Pour demarrer votre instance de serveur Zope, il suffit d'executer le pro- 
gramme DOS runzope.bat qui se trouve dans le repertoire 
C : \zope\i nstances\Pl oneDev\. 



Sous Linux ou Unix 
Preparation 

Creez un compte utilisateur specifique, que vous pouvez nommer zope. C'est 
cet utilisateur qui executera le serveur Zope. Creez un repertoire specifique 
pour heberger l'installation, typiquement /usr/local/zope, et parametrez 
l'utilisateur zope comme proprietaire de ce repertoire. Telechargez l'archive 
du code source de Zope dans un sous-repertoire temporaire, par exemple / 
usr/local/zope/tmp, decompressez-la puis deplacez le repertoire obtenu sous 
/usr/local/zope. 

Vous etes maintenant pret a lancer la compilation du logiciel. 



Attention 

II est recommande de ne pas installer Zope en tant qu'utilisateur root. 



Pre-requis 

Les logiciels suivants doivent etre installes sur la 
machine : 

• Python 2.3.3 ou plus recent ; 

• un compilateurC tel que gcc (GNU C 
Compiler) ; 

• GNU make. 



B.A.-BA La commande tar 



La commande tar permet de decompresser un 
fichier d'archive. Pour information, « tar » signifie 
Tape Archive. II s'agit du programme historique 
sous Unix permettant de faire des sauvegardes sur 
bande magnetique. 
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AIDE 



La commande ./configure -help permet de 
trouver toutes les options fournies par le script de 
configuration. 



Compilation et installation du logiciel 

Pour compiler le code source et lancer l'installation de Zope, executez les 
trois commandes suivantes l'une a la suite de l'autre : 

./configure — prefix=/usr/local/zope/zope27 
make 

make install 



ATTENTION Plusieurs versions de Python installees 

Si vous avez plusieurs Python sur la machine, le programme de configuration utilise la 
version 2.3.3 par defaut. Si vous le desirez, il est possible de specifier une version plus 
recente, en utilisant I'option -with--python. 



AIDE 



La commande mkzopeinstance.py — help 
permet de trouver toutes les options avec lesquel- 
les vous pouvez specifier la creation de I'instance. 



Creation de I'instance Zope 

Pour creer votre instance de serveur, executez le script Python 
mkzopeinstance.py disponible dans le repertoire bin du logiciel Zope : 

cd /usr/local/zope/zope27/bin 
mkzopeinstance.py 

Le script vous demande de specifier le nom d'utilisateur et le mot de passe a 
utiliser pour la creation du compte d'administration de I'instance (compte 
initial). 



Demarrage du serveur 

Pour demarrer votre instance Zope, vous pouvez simplement utiliser le script 
runzope fourni par I'instance : 

cd /usr/local/zope/PloneDev/bin 
./runzope 



Installation de produits d'extension 



ASTUCE 



Le dossier correspondant a un produit Zope est 
reconnaissable entre autres par un module special 
qu'il contient, nomme init .py. 



Vous devez ensuite installer les produits d'extension du serveur Zope (pre- 
sentes au debut de ce chapitre). Pour installer un produit d'extension, il suffit 
de decompresser l'archive telechargee et de copier le(s) dossier(s) obtenu(s) 
dans le repertoire des produits, typiquement /PloneDev/Products. Ensuite, il 
faut demarrer (ou re-demarrer) le serveur pour que les nouveaux produits 
soient pris en compte. 
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Prise en main du serveur 



Pointez votre navigateur sur une URL du type http://localhost:8080/manage (ou 
http://127.0.0.1:8080/manage), afin d'acceder a l'interface de management de 
Zope. 

Authentification 

Pour acceder a l'interface de management de Zope (ou ZMI), vous devez 
vous authentifier grace au compte d'administration (admi n par defaut) cree 
lors de l'installation de Zope. 



Logged in as ad 



I Zope Quick Start 



•i Root Folder 



B isl ControLPanel 
acl_users 
Tl temp_folder" 
© Zope Corporation 
Refresh 



□ Folder at / 




Helpl 










Iselect type to add... __J Add 












Last Modified 


r ControLPanel (Control Panel) 




2004-02-15 22:56 


r~ f_] acl_users (User Folder) 




2004-02-15 22:56 


r~ browser_id_manager (Browser Id Manager) 




2004-02-15 22:56 


r~ © error_log 




2004-02-15 22:56 


I - °$ index_html 


1 Kb 


2004-02-15 22:56 


r~ +► session_data_manager (Session Data Manager) 




2004-02-15 22: 56 


\~ <> i> standard_error_message 


1 Kb 


2004-02-15 22:56 


p <> $ standard_html_footer 


1 Kb 


2004-02-15 22:56 


r~ <> # standard_html_header 


1 Kb 


2004-02-15 22:56 


J~ Q standard_template.pt 


1 Kb 


2004-02-15 22:56 


I - frl temp_folder 




2004-02-15 22:56 



Figure 3-3 Interface d'administration de Zope 



Produits installes 

En cliquant sur l'objet nomme Control_Panel, puis sur l'objet Products, vous 
pouvez voir les objets representant tous les produits installes : les produits de 
la distribution Zope par defaut, et tous les produits et options de la plate- 
forme Plone. 
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= Type Name 

H p 0 Archetypes (Installed product Archetypes (1.2.4)) 

§ □ 0 BTreeFolder2 (Installed product BTreeFolder2 (BTreeFolder2-0.5.0+)) 

01 

£ I - 0 CMFActionlcons (Installed product CMFActionlcons) 

Dl 

.= □ 0 CMFCalendar (Installed product CMFCalendar (CMF-1.4.3-rcl)) 

.2 r #CMFCore (Installed product CMFCore (CMF-1. 4. 3-rcl)) 

o r #CMFDefault (Installed product CMFDefault (CMF-1. 4. 3-rcl)) 

r f CMFFormController (Installed product CMFFormController (RC2)) 

r #CMFPIone (Installed product CMFPIone (2.0)) 

I - 0 CMFQuicklnstallerTool (Installed product CMFQuicklnstallerTool (1.4)) 

r #CMFTopic (Installed product CMFTopic (CMF-1.4.3-rcl)) 

r 0 DCWorkflow (Installed product DCWorkflow (CMF-1.4.3-rcl)) 

f" 0 ExternalMethod (Installed product ExternalMethod (External Method- 
1-0-0)) 

I - 0 Formulator (Installed product Formulator (Formulator 1.6.1)) 

f" 0 GroupUserFolder (Installed product GroupUserFolder (2.0Beta2)) 

r #MIMETools (Installed product MIMETools) 

r #MailHost (Installed product MailHost (MailHost-1-3-0)) 

r #OFSP (Installed product OFSP (OFSP-1-0-0)) 

V 0 PageTemplates (Installed product PageTemplates (PageTemplates-1- 
4-0)) 

y 0 PlacelessTranslationService (Installed product 

PlacelessTranslationService (l,0fork-rcl (UNRE LEASED/CVS))) 

Figure 3-4 Produits enregistres sur le serveur Zope 



En resume... 

Nous avons installe toutes les briques logicielles pour la mise en ceuvre de 
notre systeme de gestion de contenu Zope/CMF/Plone. 
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Configuration de Plone 



SOMMAIRE 
Instanciation du site 

► Configuration et administration 

► Configuration avancee 

MOTS-CLES 

► Architecture 

► Control Panel 

► Administration 

► Utilisateurs 

► Groupes 
Configlets 

■ Multilingue 



Architecture | Control Panel | administration | groupes | configlets | multilingue 



Configuration de Plone 



© Ajout/Suppression de produits 
9 Journal d'erreurs 

Parametres de la messagerie 
Ci> Parametres du portail 
(n) Apparence 

^Administration des Utilisateurs et Groupes 



Le chapitre precedent a permis d'installer notre serveur Zope/Plone de developpe- 
ment ou d'integration. Nous allons maintenant, via I'interface d'administration de 
Zope, puis a I'aide des panneaux de configuration fournis par Plone, aborder la 
configuration des objets d'infrastructure du site Plone qui servira a integrer les 
services de I'intranet. Nous verrons notamment les elements d'administration des 
utilisateurs et la strategie a adopter pour gerer de maniere deleguee les espaces 
de contenu. 



.-BA Interface d'administration Zope 
(Zope Management Interface) 



C'est I'interface via laquelle Ton peut faire des 
actions de configuration poussees sur les objets 
techniques d'un site Zope. Pour y acceder, il suffit 
d'ajouter /manage a I'URL d'acces au site; par 
exemple sur votre machine de developpement, 
vous utilisez : 

► http://1 27.0.0.1 :8080/intranet/manage. 



Instanciation du site 

Pour demarrer la configuration du site Plone, vous devez acceder au serveur 
Zope via I'interface d'administration et ajouter un objet de type Plone Site. 
Vous obtenez alors un formulaire de saisie des premiers parametres de l'objet 
qui va constituer le site. 



Add Plone Site 



Enter an ID and click the button below to create a new Plone site. 
Id 



|intranet 
Title 



|lntranet 
Membership source 



Create a new user folder in the portal 
Description 



Add Plone Site 



Figure 4-1 Parametrage de creation d'une instance de site Plone 



JARGON User Folder 



L'objet de type User Folder nomme acl_users 
est un conteneur technique permettant I'authenti- 
fication des utilisateurs du serveur Zope. En effet, 
c'est dans ce dossier que sont stockes les comptes 
utilisateurs du systeme, avec leur mot de passe et 
leurs droits (roles). Le User Folder qui sera uti- 
lise pour le site Plone est du type Croup User 
Folder. 



Dans ce formulaire, vous etes invite a fournir les informations suivantes : 

• Id : c'est l'identifiant de l'objet, comparable au nom d'un fichier sur un 
disque dur. Par exemple, vous pouvez choisir le nom website. 

• Ti tl e : c'est le titre donne au site. Ce parametre est tres reutilise apres 
dans le site. II est modifiable a tout moment. 

• Membership source : identifie l'endroit de stockage de la base des utilisa- 
teurs du site. II existe deux valeurs : Create a new user folder in the 
portal ou I have an existing user folder and want to use it instead. 
La premiere option precise qu'on veut que le portail heberge en son sein 
la liste des utilisateurs. C'est le choix par defaut, que nous ferons ici. La 
seconde alternative permet de reutiliser le User Folder (conteneur des 
comptes utilisateurs nomme acl_users) existant a la racine (ou a un 
niveau superieur de l'arborescence) de Zope. 

• Description : description sommaire du site et des principes qui l'animent. 
Cette information sera reutilisee par le site a tous les moments ou il 
donne une description de lui-meme (notamment pour la page d'accueil, 
les moteurs de recherche, ou la syndication). 

Une fois ces informations renseignees, cliquez sur le bouton Add Plone Site. 
Le serveur declenche le processus de creation et de configuration initiale du 
site. Cela prend quelques secondes. . . et a la fin, la page d'accueil du nouveau 
site s'affiche dans le cadre droit de I'interface d'administration. 
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5» P I ® o e 



home | | news I | members - 



[El 



$ you ace here: home s- welcome to plone 



^adrnin : my folder : my preferences : undo : plone setup : log out 



navigation I 



O Home 

CD Members 



I contents I | ~ 



" 1 I edit | | properties | 

I add new item H state; visible ' 



Welcome to Plone 



This welcome page is used to introduce you to the Plone 
Content Management System. 

You can customize this frontpage by clicking the edit tab on 
this document if you have the correct permissions. Create 
folders and put content in those folders. Folders will show up 
in the navigation box if they are published. It's a very simple 
and powerful system. 

For more information; 

O PIone website 

fl Zope community 

Q CMF website 



recent items 



No items published or 
changed since your last 



« December 2003 : 



Su Mo Tu We Th Fr Sa 



1 2 3 4 S 6 

7 6 9 10 11 12 13 

14 15 16 17 18 19 20 

"ill 22 23 24 25 26 27 
28 29 30 31 



Le lien plone setup ou configurer plone, 
en francais, apparait parce que vous avez des 
droits d'administration. Toutes les fonctionnalites 
exposees sont protegees par des permissions. Le 
role Manager, principal role de I'administrateur 
du site, vous permet d'effectuer toutes les actions 
de modification et d'administration. 



Figure 4-2 Le nouveau site Plone 



Configuration et administration 

Pour aller plus loin dans le parametrage du site, vous pouvez utiliser l'inter- 
face d'administration de Plone nommee Plone Control Panel. Pour acceder a 
cette interface, il suffit de cliquer sur le lien plone setup (correspondant a 
l'URL http://1 27.0.0.1 :8080/intranet/plone_controLpanel). 



Configuration de Plone 



Espace de configuration de Plone et de ses produits d'extension. 



Configuration de Plone 



£2> Ajout/Suppression de produits 
9 Journal d'erreurs 

Parametres de la messagerie 
Ci) Parametres du portail 

Apparence 

^Administration des Utilisateurs et Groupes 
£2 Interface d'administration de Zope (ZMI) 

Configuration des produits d'extension 



Pas de panels de configuration disponibles. 



Figure 4-3 Plone Control Panel 

Vous pouvez alors visiter la page de configuration ou d'administration qui 
vous interesse parmi les options disponibles. 



ASTUCE Interface multilingue 



Sans que vous n'ayez eu a parametrer quoi que ce 
soit, I'interface multilingue de Plone apparait dans 
une langue precise. On remarque qu'il s'agit de la 
langue parametree sur le navigateur de I'utilisa- 
teur. 



ADMINISTRATION 
Principales pages d'administration 

Ajout/Suppression de produits 
Journal d'erreurs 
Parametres du portail 
Parametres de la messagerie 
Apparence (ou Habillage) 
Administration des Utilisateurs et Groupes 
Interface d'administration de Zope 
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ARCHITECTURE Composants de services 

• Moteur d'indexation du contenu (po rtaT _catal og) - Ce com- 
posant est une version evoluee du moteur d'indexation de 
Zope, le ZCataTog. Techniquement, il s'agit d'un wrapper (en 
frangais enveloppe) autour du ZCataTog. C'est un element 
central de Plone. II permet d'indexer tous les contenus ajoutes 
au site, et de construire les pages qui ont besoin d'agreger 
dynamiquement du contenu (page d'accueil, page correspon- 
dent a une rubrique, etc.) rapidement et simplement. 

• Gestionnaire des actions (portaT_actions) - Ce composant 
permet de parametrer les differentes actions definies pour le 
contexte global du site. Certaines actions sont deja parame- 
trees au niveau de la logique de configuration du CMF. Les 
autres sont ajoutees par le concepteur du site ou le deve- 
loppeur, soit directement via I'interface de ce composant, soit 
via le parametrage des actions au sein des autres composants 
qui remplissent le contrat Action Provider (en francais, 
Fournisseur d'actions) vis-a-vis du portaT^actions. La liste 
des fournisseurs d'actions est parametree, et verifiable en acce- 
dant a I'onglet Acti on Provi ders du composant. 

• Gestionnaire d'icones pour I'interface utilisateur 
(portaT_actionicons). 

• Support des commentaires sur le contenu (portal_discussion) : 
Grace a ce composant, si I'administrateur le parametre au 
niveau d'un type de contenu donne, les contenus bases sur ce 
type de contenu peuvent etre commentes par les utilisateurs 
qui les consultent. 

• Gestionnaire des membres (portaT_membershi p) - Ce com- 
posant gere le mecanisme d'authentification des membres. II 
permet de definir une interface stable, independante des imple- 
mentations des acT_users utilisees. 

• Gestionnaire des profils des membres 
(portaT_memberdata) - Ce composant permet de definir les 
proprietes ou attributs que le concepteur de site CMF desire 
conserver pour les membres. II esttres simple d'ajouter de nou- 
veaux attributs au profil des membres. 

• Gestionnaire des groupes (portaT_groups). 

• Gestionnaire des profils des groupes (portaT_groupdata). 

• Gestionnaire des metadonnees du contenu (portaT_ 
metadata) : Ce composant fournit I'interface de gestion des 
metadonnees conformement au standard Dublin Core (principa- 
lement, les attributs TitTe, Description, Subject, 
Format, Contributors, Language, Rights). Notez que 
les composants portaT_metadata et portaT_cataTog colla- 



borent etroitement pour permettre d'avoir un outil efficace 
pour la recherche et la decouverte d'informations : pour chaque 
attribut de meta-donnee, il existe au sein du portal_catalog un 
index permettant d'indexer reformation correspondante. 

• Moteur de I'interface utilisateur (portaT_skins) : Ce compo- 
sant fournit les services de I'interface graphique du site. II inte- 
gre un mecanisme permettant de proposer plusieurs skins. Une 
skin est un ensemble de mise en page graphique coherent. Cela 
va dans le sens de la sacro-sainte separation con- 
tenu/design/logique que tout gestionnaire de contenu se doit 
de respecter. L'objectif premier est de permettre au concepteur 
de personnaliser I'interface par defaut en modifiant les diffe- 
rents elements de presentation. 

• Gestionnaire des types de contenu (portaT_types) - Ce com- 
posant fournit I'interface de parametrage de tous les types de 
contenu disponibles pour les gestionnaires de contenu. Par 
exemple, vous definissez, pour chaque type de contenu, les 
actions par lesquelles I'utilisateur interagit avec le contenu, en 
fonction de ses droits. 

• Moteur du workflow (portaT j/vorkflow) - Ce composant aide 
a definir le cycle de vie du contenu. En effet, le contenu passe 
par plusieurs phases pendant sa duree de vie, de sa creation a 
son archivage ou sa destruction. Le composant de workflow 
fournit une machine a etats correspondant a un diagramme 
dans lequel les transitions sont les actions permettant de mani- 
puler le contenu. II collabore avec le composant 
portaT_types puisque le workflow est defini pour chaque type 
de contenu disponible sur le site. 

• Support de la syndication (portaT_syndi cation) - Ce com- 
posant gere la syndication du contenu a travers le site. Pour 
activer la syndication, le concepteur ou I'administrateur du site 
doit utiliser le bouton EnabTe Syndication present sous 
I'onglet Properties du composant. A partir de la, le lien 
Syndication, present dans la boTte d'actions gauche, permet 
a I'administrateur ou au membre « proprietaire » du dossier 
courant, d'activer et de parametrer la syndication du contenu 
de ce dossier. 

• Support de I'annulation des modifications (portaT_undo) - Ce 
composant permet I'annulation des actions effectuees sur le 
contenu, pour I'utilisateur autorise. 



• Gestionnaire de I'URL du site (portal _url) - Ce composant 
offre un mecanisme permettant d'avoir acces a I'URL absolue 
du site, en d'autres termes I'URL du « toit » du site. Sa fonction 
est utile chaque fois que Ton a besoin de generer I'URL d'un 
endroit precis au sein du site et qu'on n'est pas dans le con- 
texte de I'objet representant la page en question ; une fois 
qu'on a obtenu I'URL du site, on peut la completer pour obtenir 
I'URL voulue. 

• Composant de controle et validation des formulaires 
(porta~l_form_contro~ner) - Ce composant est tres puis- 
sant et facilite grandement la tache du developpeur et de I'inte- 
grateur Plone. II fournit un mini-framewor/c de gestion de la vali- 
dation et des actions qui interviennent sur un formulaire du site 



Q_ 

-o 

1 c 

_o 

"5 

k— 
3 

ou tout simplement sur un script qui doit effectuer un traite- £ 

ment et redonner la main a I'utilisateur. <3 

i 

Gestionnaire de la creation des objets de contenu "* 
(porta~l_factory) - Ce nouveau composant intervient pen- 
dant la phase de creation des objets de contenu, apres le pas- 
sage par le formulaire d'edition et les mecanismes de valida- 
tion. 

Gestionnaire d'un calendrier d'evenements (portal_ 
calendar) - Ce composant permet la gestion de contenus de 
type Event, et I'acces au contenu du site par des criteres de 
date. 



ARCHITECTURE Composants de configuration ou composants i 

• Referentiel des proprietes du site (portal_properties) - Ce 
composant fournit au site un service de stockage et de gestion 
de proprietes. Ainsi, les developpeurs et les concepteurs de 
sites peuvent y definir des fiches de proprietes 
(PropertySheets) dont ils se servent pour rendre parametra- 
bles les fonctionnalites au sein du site. 

• Moteur du PI one Control Panel (portal_control panel) - 
Ce composant gere les elements (formulaires, scripts, images) 
qui fournissent les pages d'administration de Plone. Ces ele- 
ments sont nommes configlets. 



• Fonctions utilitaires de Plone (plone_utils) - Ce composant 
fournit des fonctions utilitaires communes dont on se sert fre- 
quemment dans la logique applicative d'un site Plone, par 
exemple, la fonction d'edition des metadonnees d'un contenu. 

• Outil de gestion de memoire cache specifique a chaque type de 
contenu (cachi ng_pol i cy_manager). 

• Outil de gestion de la migration (portal_migration)... 

• Outil de configuration de produits d'extension Plone 
(portal _qui cki nstal 1 er). . . 



ARCHITECTURE Composants « tierce partie » 

Les composants specialises suivants sont ajoutes a la racine du 
site lorsque vous configurez le produit correspondant via la page 
d'administration Add/Remove Products. 

ARCHITECTURE Autres objets de ('infrastructure 

• Le Croup User Folder, le systeme d'authentification et de 
gestion des groupes du site. 

• Les conteneurs Members et CroupWorkspaces permettent 
(par defaut) de stacker le contenu respectivement des membres 
et des groupes de travail (pour les besoins du Groupware). 

• L'objet Mail Host permet d'envoyer des messages electroni- 
ques a partir du site. On retrouve la valeur qu'on a saisie pour 
le champ SMTP Server lors de I'installation. Ce composant est 
automatiquement installe a la racine du site. 

• L'objet content_type_registry contient une definition de 
correspondance entre les types MIME et les types de contenu, 
qui eux sont definis au sein du composant portal_types. 



• Les composants fournis par Archetypes : archetype tool... 

• Les composants fournis par Portal Transforms: 
portal_transforms, mimetypes_registry... 



• L'objet Cookie Crumbier (cookie_authenti cation) est 
responsable de maintenir des parametres d'authentification, au 
sein d'un cookie stocke dans le navigateur de I'utilisateur con- 
nects. On peut notamment y changer les noms des variables 
serialisees dans le cookie. Grace a l'objet Cookie Crumbier, il 
est possible de demander le login et le mot de passe de I'utili- 
sateur au sein d'un formulaire HTML classique. 

• Les objets HTTP Cache Manager (HTTPCache) et RAM Cache 
Manager (RAMCache). 

• L'objet qui expose le journal d'erreurs (error_log). 
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Parametres generaux du site 

Les parametres du fonctionnement general du site Plone sont regroupes 
dans un formulaire accessible via le lien Portal Settings. Les parametres 
essentiels sont presentes ci-dessous : 

• Portal ti tl e : vous retrouvez ici le titre du site, que vous aviez entre via le 
formulaire de creation. 

• Portal descri pti on : vous retrouvez ici la description du site. 

• Portal 'From' name : nom utilise pour l'en-tete From des messages envoyes 
par le site (notification par courrier electronique), typiquement le mes- 
sage de confirmation a envoyer au membre du portail lors d'une nouvelle 
inscription ou lorsqu'il veut retrouver son mot de passe. 

• Portal 'From' address : adresse utilisee pour l'en-tete From des messages 
envoyes par le site. 

• Default language : langue par defaut utilisee dans les proprietes (attri- 
buts) des objets ; selectionnons done f rench. Ce parametre est important, 
etant donne que le site peut etre multilingue. 

• Password policy : definit la politique de selection du mot de passe initial 
lors de l'inscription d'un membre. Pour une gestion simplifiee, il est pro- 
bablement preferable de conserver le choix par defaut : Allow members to 
select their initial password. 

Une fois ces choix effectues, cliquez sur save pour valider et mettre a jour le 
site avec vos changements. 

— Informations de configuration 

Titre du portail ■ 

Indiquez le titre de votre portail Plone. 

[intranet | 
Description du portail 

Cette description est utilisee en differentes occasions, notamment 
pour les contenus syndiques, Elle devrait rester assez breve. 
Le site intranet de la Societe Geniale. 



I a 

Nom d'expediteur 

Quand Plone envoie un courrier electroniquej e'est ce nom qui 
apparait comme expediteur du message. 
|Portal Ad ministrator 

Adresse d'expediteur* 

Quand Plone envoie un courrier electronique, e'est cette adresse qui 
apparait comme expediteur du message, 
intranet admin@societegeniale. cor 

Langue par defaut 

Specifiez la langue par defaut pour les nouveaux documents. 
| French 



Figure 4-4 

Parametres du portail 



Connexion au serveur de courrier electronique 

Pour renseigner les parametres de connexion au serveur de messagerie (ser- 
veur SMTP), visitez la page correspondant au lien Mail Settings. Les para- 
metres en question sont : 

• SMTP server : definit le nom DNS (ou l'adresse IP) du serveur SMTP qui 
sera utilise pour 1' envoi de courriers electroniques a partir du site. Si le 
serveur SMTP (Sendmail, Postfix, Qmail ou autre) est installe sur la 
meme machine, il suffit de garder la valeur par defaut, 1 ocal host. 

• SMTP port : definit le port d'ecoute du serveur SMTP, dont la valeur par 
defaut est 25. 



Comptes utilisateurs et groupes 



B.A.-BA Le DNS 



DNS ou Domain Name System est un service fonda- 
mental des reseaux TCP/IP en general, et d'lnter- 
net en particulier. C'est le service charge de faire la 
correspondance entre le nom d'une machine con- 
nected au reseau (ex. serverl .acme.com) et 
l'adresse IP unique qui identifie cette machine. 



Comptes utilisateurs 

En general, les comptes des membres du site sont automatiquement crees a 
leur inscription. Neanmoins, l'administrateur peut explicitement creer de 
nouveaux comptes. Pour creer un nouveau compte, il suffit d'acceder a la 
page de gestion des utilisateurs (onglet Utilisateurs) a partir du panneau Admi- 
nistration des Utilisateurs et Groupes, et d'utiliser le bouton ajouter... reserve a 
cet effet. 



— Informations personnelles 
Nom complet 



Saisissez votre nom complet, p. ex. Jean Dupont. 
[]ean Dupont | 

Nom d'utilisateur ■ 

Indiquez le nom d'utilisateur que vous souhaitez utiliser, 
generalernent quelque chose comme « jdupont ^, Pas d'espaces ni 
de caracteres speciaux. Les noms d'utilisateurs et les mots de 
passe respectent la casse. C'est ce nom qui vous servira a vous 
identifier sur ce site. 
Ijdupont | 

Adresse electronique ■ 

Indiquez votre adresse electronique. Cela vous permettra de 
recevoir un rappel de votre mot de passe en cas d'oubli. Nous 
respectons votre vie privee et ne communiquerons pas cette 
adresse a des tiers. 



jdupont@societegeniale.com 
Mot de passe ■ 

Saisissez le mot de passe de votre choix (5 caracteres minimum). 



Confirmer le mot de passe ■ 

Saisissez a nouveau le mot de passe pour confirmation. 



V Envoyer le mot de passe par courriel ? 



CULTURE Serveur SMTP 



Le serveur SMTP est le serveur responsable de 
remission des courriers electroniques. C'est a un 
serveur SMTP que votre client de messagerie con- 
fie vos precieux messages pour les envoyer. Si vous 
utilisez un service d'hebergement professionnel, la 
machine heberge surement deja un tel serveur ; 
dans ce cas, c'est local host qu'il convient de 
mettre. Dans le cas oil vous testez le serveur 
depuis votre domicile, il faut specifier le serveur 
SMTP de votre fournisseur d'acces, par exemple 
smtp.wanadoo.fr. 



Figure 4-5 

Ajout d'un membre 
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— Proprietes du groupe 

Nom ■ 

Un identifiant unigue pour le groupe. Vous ne paurrez 
pas le changer plus tard, 
|rnarketing | 

titre 

|Groupe du service Marketing | 
description 



adresse electronique 



: enregistrer 



Figure 4-6 Ajout d'un groupe 



Groupes 

Vous pouvez maintenant ajouter les groupes de l'intranet. Pour ajouter un 
groupe, cliquez sur l'onglet Groupes a partir du panneau de gestion des utili- 
sateurs et des groupes, puis utilisez le bouton ajouter... Vous pouvez definir 
un groupe de membres par son nom, ses metadonnees (par defaut, titre et 
description), et son adresse e-mail. 

Pour editer les informations d'un groupe, il suffit de cliquer sur le lien du 
groupe (colonne nom du groupe) dans la matrice Groupes/Roles. Vous arrivez 
sur la vue du groupe choisi, offrant deux onglets de parametrage : celui des 
proprietes et celui des membres. 

La methode consiste a creer des groupes correspondant a des equipes ou a 
des services au sein de l'entreprise (par exemple Marketing), afin de mettre 
en ceuvre une gestion de contenu deleguee aux services qui en ont besoin. 

Concretement, chaque fois qu'il est utile d' avoir une gestion deleguee au 
niveau d'une rubrique ou d'un dossier du site, nous attribuerons au groupe 
concerne le role requis (par exemple, le role Proprietai re) de maniere locale. 



recherche d'un groupe: 



nom du 
groupe 



M 17 

marketing 



roles 



| A rechercher | 



membre 



suppression 

rnoderateur administrateur proprietaire de groupe 



appliquer les changements 



Figure 4-7 Matrice Groupes / Roles 



Affecter des utilisateurs a un groupe 

Pour affecter des membres a un groupe, cliquez sur l'onglet membres du 
groupe a partir de la vue du groupe. Cette interface, completement intuitive, 
vous permet de selectionner des membres du site et de les associer au groupe. 



Figure 4-8 

Membres d'un groupe 



Recherche de nouveaux membres 



chercher: 


rechercher 


r 


nom du groupe 


r 


& jdupont 



ajouter les utilisateurs selectionnes a ce groupe 

Liste des membres appartenant actuellement 
au groupe 



r 


nom 


adresse electronique 


PI 


£ jdupont (Jean Dupont) 


H3jdupont@societegeniale.com 



enlever le(s) utilisateur(s) selectionne(s) du groupe 
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Politique de gestion deleguee 



La creation des dossiers qui serviront a stocker le contenu centralise (parfois 
appele « base documentaire »), fait egalement partie du travail de configura- 
tion initial. L'administrateur du site peut creer chaque dossier, puis y para- 
meter les droits locaux de creation et modification de contenu. 

Comme nous l'avons vu au chapitre 2, l'arborescence conseillee pour la ges- 
tion du contenu est du type : 

[Contenu] 
Market! ng 

- actus 

- produits 

- liens 
SAV 

- actus 

- procedures 

- solutions 

- liens 
Di recti on 

- procedures 

- memos 

- gestion 

Ainsi, nous pouvons accorder aux membres du groupe marketing les droits de 
gestion du contenu au sein du dossier Marketing. Cela consiste a leur 
accorder le role local Proprietai re, en passant par l'onglet Partage du dossier 
(figure 4-9). 



Ajouter des permissions de partage aux groupes 

Un groupe perrnet d'attribuer a une categorie d'utilisateurs un certain nombre de services 
qu'ils doivent partager. Choisissez un ou plusieurs groupes, et attribuez leur un role. 



Groupes disponibles 



r 


nom 




marketing 



Role a attribuer | Administrate^ 



Administrateur 
Membre 



utilisateurs selectionnes 



Figure 4-9 Parametrage de roles locaux (Partage) 



Configuration avancee 



Exemples de produits d'extension 

Ces produits doivent avoir ete installed sur le sys- 
teme de fichiers du serveur (dans le dossier 
/Products). Quelques produits d'extension a con- 
figurer : 

• PloneLanguageTool 

• Archetypes 

• PortalTransforms 

• PloneArticle 

• PloneExFile 

• ZAAPIugins 

• H8NLayer 

• Epoz 



Produits d'extension 

Tous les produits qui apportent de nouvelles fonctionnalites pour etendre 
Plone peuvent etre configures via la page d'administration Ajout/Suppression 
de produits. 

II est conseille de configurer les produits PloneLanguageTool, Archetypes, 
et PortalTransforms, afin d'integrer leurs fonctionnalites au site. 



Produits installables — 
r & ArchExample 

r S Archetypes 1.2.5-rc4 

Si Description du produit 

r S Epoz 0.8.0 

Si Description du produit 

r IS GrufSpaces 0.1 

Si Description du produit 

r Q> PloneArticle 2.0Betal 

Si Description du produit 

r L:> PloneErrorReporting 0.1 

Si Description du produit 

r 13 PloneExFile 2.0Beta2 

Si Description du produit 

r a PloneLanguageTool UNRE LEASED/CVS 
r a PortalTransforms 1.0.2-final 

r a ZAAPIugins 2.0 

Si Description du produit 



Figure 4-10 Configuration de produits 



Interface graphique 



Pour tous les details sur le parametrage de Inter- 
face graphique du site, reportez-vous au chapitre 
suivant : Personnalisation graphique. 



Rappel 



ZMI : Zope Management Interface 



Multilinguisme 

Le site Plone peut fonctionner en mode multilingue. Pour l'instant, grace au 
composant PlacelessTranslationService, la langue de l'interface utilisateur 
est la langue parametree au niveau de votre navigateur. 

Lorsque vous avez configure le produit PloneLanguageTool , un nouveau com- 
posant nomme portal_languages a ete ajoute au sein du site. Ce composant 
offre une interface de controle de la negociation du multilingue entre le 
navigateur et le serveur. En visitant le composant portal_languages via la 
ZMI, vous pouvez ainsi parametrer differentes langues pour la gestion de 
l'interface multilingue, et choisir le « francais » comme langue par defaut. 
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Q_ 

Q> 
T3 

2 

ATTENTION Jeu de caracteres =§ 

3 

Si vous remarquez que les caracteres accentues i 
dans les premiers contenus que vous creez ne 
s'affichent pas correctement, vous devez ajuster 
le jeu de caracteres parametre pour le site. Via 
la ZMI, visitez I'objet site_properties situe 
au sein du composant porta~l_properties. 
Modifiez le parametre defau~lt_charset de 
cette fiche de proprietes avec la valeur ISO- 
8859-1. II s'agit du jeu de caracteres par 
defaut pour un site en francais. 



Autres outils d'administration 

• le journal d'erreurs (error_~log), 

• I'assistant de migration (portaljnigration). 

Figure 4-11 Parametrage du composant portal_languages 



Language 
English 

French 



Figure 4-12 BoTte permettant de changer de langue 



En resume... 

Nous avons done une suite de composants qui collaborent pour fournir les 
services de la gestion de contenu. Nous allons maintenant nous lancer dans 
la mise en ceuvre de letude de cas. Pour chacun des aspects de la realisation 
du site (graphisme, fonctionnalites, deploiement), nous ferons appel a un 
certain nombre de ces composants. 



Default language 

if content requested is not available in the language the user preferred, content will be presented in the fallback language 
| French ^] 

Allowed languages 

please narrow the range of languages that can be added in your portal 
use the CTRL key to select / desel ect single Items 











Esperanto (eo) 




Estonian (et) 




Faroese (fo) 




Fiji (fj) 




Finn sh hi 








Frisian (fy) 




Galician (gl) 


: 



I - Allow combined language codes like de_DE or en_UK. 

Negotiation Scheme 

Check the language negotiation schemes that apply to this site 

1. B Use language codes in URL path for manual override. 

2. !^ Use cookie for manual override. 
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Personnalisation 
graphique 



SOMMAIRE 

Methodologie et bases 
theoriques 

Le gabarit des pages 

> La charte graphique 

► La page d'accueil 

MOTS-CLES 

CSS 
XHTML 
Templates 
ZPT 

Ergonomie 
Accessibilite 



CSS | XHTML | templates | ZPT | ergonomie | accessibilite 



TopStyle Pro 3.0 [C:\Documents and Settings '.kayeva Bur 



! File Edit Search Preview View HTML Tools Options Help , 

p 



{J | r3 Browsers ' | 4* ' | ( IB Layout • j Q] Panels ' | Q 



plone.css" | 



«L'>ort al -global nav { 

back ground- col or : transparent.; 
border -collapse: collapse; 
padding: Oeni Oeni Oeni 2em; 
white-space: nourap; 
list-style: none; 
margin: j; 
height: auto; 
line-height: normal ; 

I 

#[>ortal-tjlolialnav li { 

display: inline; 

) 

# portal -global nav li a { 

background-color: transparent; 
border-color: adtml-globalBorderColor; ; 
border-width: sdtml -border Width; ; 
border-style: sdtml-borderStyle; idanl-borderStyle ; 
color: 4,dtml-globalFontColor ; ; 

mar gin- right: 0. 5em; 

padding: Oem 2em; 

text-decoration: none; 

text- transform: sdtml-textTransform; ; 

} 

# portal -global nav 11. selected a { 

back ground- col or : sdtml-globalBackgroundColor ; ; 

border: i,dtml-border¥idth; .idtiLil -border Style; sdtiul- globalEorder Color ; ; 

border -bottom: ■sdtml-globalBackgroundColor ; sdunl-borderHidtii; «dtml-border Style; 

color: sdtml-global Fontcolor;; 

1 

#portal-globalnav li a:hover { 

background-color : sdtml-globalBackgroundColor ; ; 
border-color: sdtml-globalBorder Color ; ; 
border-bottom-color : sdtml-globalBackgroundColor ; ; 
color: sdtml -global FontColor ; ; 



i sdtml -borderStyle; 



Vous avez travaille avec votre graphiste pour realiser la maquette de votre site 
intranet. Vous avez ensuite extrait les elements graphiques (principalement des 
images) et produit la version HTML de cette maquette. 



Methodologie et bases theoriques 



References et sites incontournables 

« Jeffrey Zeldman presents... » : 

► http://www.zeldman.com 
Eric Meyer : 

► http://www.meyerweb.com/ 
A List Apart : 

► http://www.alistapart.com 
The Web Standards Project : 

► http://www.webstandards.org/ 
CSS Zen Garden : 

► http://www.csszengarden.com/ 
Tantek Celik : 

► http://tantek.com 



Meme la phase de personnalisation graphique necessite de la methode. La 
demarche methodologique est facilitee par le fait que Plone fournit une 
interface utilisateur structuree. Ainsi, vous pouvez organiser votre travail en 
differentes phases, chaque phase faisant appel a une technique ou une tech- 
nologic specifique. Typiquement, vous devez travailler sur les elements 
suivants : 

• Le gabarit des pages, structure de base de toutes les pages du site. On y 
retrouve l'ensemble des elements de navigation (liens internes, liens 
externes, menus contextuels, breadcrumbs, portlets, etc.) etla zone centrale 
reservee au contenu. 

• La charte graphique - C'est l'ensemble des elements visuels utilises pour 
la communication de l'entreprise : logos, couleurs, polices de caracteres, 
icones et pictogrammes, etc. 

• La page d'accueil - C'est une page fondamentale pour le succes d'un site, 
et d'un intranet en particulier. En effet, elle doit inciter l'utilisateur a 
revenir frequemment sur le site en lui proposant des informations perti- 
nentes (et actualisees !) et un aspect attractif. 

Dans la suite du chapitre, vous allez decouvrir, a travers des exemples, les 
outils proposes par Plone pour personnaliser l'apparence et l'ergonomie de 
votre site intranet. Vous decouvrirez notamment que l'apparence d'un site 
Plone peut etre changee sans toucher aux templates (les objets de presenta- 
tion de Zope), mais simplement en modifiant des regies dans la feuille de 
style de Plone grace au langage CSS. 

En effet, et c'est un point fondamental de Plone 2, la separation entre le 
contenu et la presentation est totale : le changement de tous les elements 
graphiques peut se faire sans meme toucher aux pages HTML de Plone. 
95 % de la personnalisation graphique peut se faire sur la base du change- 
ment des simples feuilles de style CSS2. Dit autrement, cela veut dire que 
deux sites Plone 2, graphiquement totalement differents, peuvent partager le 
meme code HTML... 

Feuilles de style CSS 

Les feuilles de style ou CSS {Cascading Style Sheets) permettent de controler 
finement la mise en page des differents elements HTML d'une page web. 
Avec CSS, vous pouvez definir la couleur d'une police, sa taille, le position- 
nement absolu ou relatif, l'espacement entre les paragraphes, les effets de 
transition affectant des liens, ou encore adapter la mise en page au media de 
sortie (ecran ou imprimante, par exemple). 
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Les normes techniques du W3C (World Wide Web Consortium) 



• XHTML - C'est la nouvelle generation du langage HTML (apres HTML 4). La grosse diffe- 
rence est que XHTML respecte le standard XML. http://www.w3.org/TR/xhtml1 . 

• CSS - II s'agit de la specification des Cascaded Style Sheets. II y a deux versions: CSS 
Level 1 et CSS Level 2 (1998). http://www.w3.org/Style/CSS. 

• DOM - La specification DOM ou Document Object Model du W3C fournit une representa- 
tion d'un document (sous la forme d'un arbre), de maniere a permettre de manipuler la 
presentation du document de maniere flexible au niveau du navigateur. Techniquement, 
le DOM permet d'interpreter chaque element d'une page HTML comme un objet accessi- 
ble en parcourant I'arbre representant le document. Par exemple, vous pouvez grace a la 
methode getElementByld definie dans le langage JavaScript, acceder aux elements de 
la page HTML et les manipuler. http://www.w3.org/D0M. 

Les recommandations pour I'accessibilite 

• Section 508- Les recommandations d'accessibilite du gouvernement americain. http:// 
www.section508.gov. 

• WAI-WCAG - La WAI (Web Accessibility Initiative) du W3C a publie une serie de directives 
denommees Web Content Accessibility Guidelines. Ces directives expliquent comment ren- 
dre les contenus web accessibles aux personnes handicapees. En les suivant, le contenu 
web pourra etre plus accessible non seulement aux personnes handicapees, mais egale- 
ment a tous les utilisateurs, independamment du programme utilisateur (navigateur clas- 
sique, logiciel vocal, telephone mobile, etc.) http://www.w3.org/WAI. 



Et Plone dans tout ca ? 



Plone respecte les normes XHTML et CSS pour son 
architecture de presentation, et les recommanda- 
tions Section 508 et Level Triple-A Conformance to 
Web Content Accessibility Guidelines du WAI 
(WAI -AAA). 



CULTURE JavaScript 

Developpe a I'origine par la societe Netscape Com- 
munications pour son navigateur, JavaScript est 
aujourd'hui un langage tres utilise pour des traite- 
ments que le developpeur veut faire executer du 
« cote client » (client-side scripting). 



Definitions 

Une feuille de style est composee de regies qui s'appliquent soit a l'ensemble 
des elements HTML du document (par exemple, l'element hi), soit a un 
element particulier qui est defini par un des attributs class ou id. 

Les regies s'appliquant au document sont incluses dans le bloc de declaration 
CSS qui est fourni par la balise speciale <style> ou au sein d'un fichier 
externe (d'extension .ess) reference dans l'en-tete du document. 

Une regie de style est composee d'un selecteur et d'une declaration. La 
declaration est composee d'un certain nombre de proprietes. 

Voici un exemple avec des declarations CSS simples. 

<style> 

hi { color: red } 

table { background-color : white ; border : lpx black solid } 

hi, h2, h3 { color: red } 
</style> 



Debut du bloc de declarations CSS. 



< Dans cette regie, hi est le selecteur, et la decla- 
ration definit pour la propriete color la valeur 
red. 

< Cette regie definit le style de l'element table 
avec une declaration composee de trois proprie- 
tes. 

< Cette regie s'applique aux trois elements hi, h2 
et h3. 

< Fin du bloc de declaration CSS. 
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En dehors des selecteurs d'elements (voir l'exemple CSS), il existe deux 
autres types de selecteurs qui permettent d'acceder a la puissance de CSS : 

• les selecteurs de classe, 

• les selecteurs d'identificateurs. 



ALTERNATIVE 



Si vous voulez que la regie ne s'applique qu'aux 
elements <di v>, vous devez la modifier en : 
div.commentaire { color: #CCCCCC } 



ASTUCE JavaScript 

Les identificateurs peuvent egalement etre utilises 
avec JavaScript grace a la methode 
getETementByld, qui permet d'acceder a I'ele- 
ment concerne (d'apres le DOM - Document Object 
Model). 



Utilisation des selecteurs de classe 

Les selecteurs de classe permettent de regrouper des elements HTML spe- 
cifiques, relatifs a un mime sujet. La regie utilisant le selecteur aura un effet 
sur tous les elements qui l'utilisent dans leur attribut class. 

Par exemple, prenons lelement div utilise avec la classe commentai re ci- 
dessous : 

<div class="commentai re" >Ceci est mon commentai re</div> 

S'il existe la regie suivante dans la feuille de style. . . 
.commentai re { color: #CCCCCC } 

. . . alors le texte « Ceci est mon commentaire » sera affiche en gris. 

Cette regie s'appliquera a toute balise que vous utiliserez avec la valeur 
commentaire, pour son attribut class, et non pas uniquement aux balises 
<div> (comme dans l'exemple). 

Utilisation des selecteurs d'identificateurs 

Les identificateurs permettent d'appliquer une regie de style a un element 
unique du document HTML. 

La declaration d'un style par identificateur se fait avec le caractere diese (#). 
Pour appliquer la regie a lelement concerne, on utilise l'attribut id. 

Dans l'exemple suivant, l'image utilise l'identificateur special Image. 
<img id="special Image" src="plone. jpg" /> 

La regie CSS suivante permet d'obtenir une image avec une bordure en 
pointille : 

#speciallmage { border-style: dashed; } 
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Les Pages Templates de Zope 

Les environnements de developpement web modernes visent a separer la 
logique applicative de la presentation. C'est la qu'interviennent les systemes 
de developpement a base de templates. D'un cote, les scripts Python effec- 
tuent les traitements de la logique applicative. De l'autre, les templates defi- 
nissent des gabarits XHTML correspondant a la charte graphique oil se 
situent des zones predefinies dediees a l'affichage des donnees fournies par 
les scripts. Dans le cas de Plone 2, on peut resumer rapidement cette separa- 
tion presentation/logique/ contenu : 

• la logique : via Python ; 

• la presentation : via CSS et ZPT (dans une moindre mesure) ; 

• le contenu : via les types de contenu. 

Zope fournit un systeme de construction de pages dynamiques, baptise Zope 
Page Templates (ZPT). Les Page Templates sont des « objets executables 
Zope » permettant de definir des pages web dynamiques dont le code est 
conforme a la norme XHTML. Cette technologie se base sur trois nouveaux 
langages : 

• TAL (^Template Attribute Language) - Complete le langage HTML en 
fournissant a ses balises des attributs permettant d'effectuer des actions 
dynamiques. 

• TALES (TAL Expression Syntax) - C'est le langage d'expression utilise 
par les attributs fournis par TAL. 

• METAL [Macro Expansion Template Attribute Language) — Permet la 
reutilisation, dans un template donne, de blocs de code definis au sein 
d'un autre template. 



B.A.-BA Attribut 

Un attribut est une valeur qui apparaTt au sein d'un element XML (en general) et done dans 
une balise XHTML. Par exemple, I'element img a un attribut sre qui contient le chemin de 
I'image a afficher. 

attribut sa valeur Balise Debut Balise Fin 



11=^ , 73 



( <img (src=^) ("logo.gif) /> 



<h3>) ( ja vie est belief (</h3>) 



xhtml requiert un «/>» Element Contenu 

a cet endroit 
(compatibilite XML) 



JARGON Template 

Le terme anglais template correspond au francais 
« gabarit ». En effet, les templates sont des scripts 
qui facilitent la mise en ceuvre de la structure ou 
du gabarit des pages d'un site web dynamique. 
Elles facilitent la construction des pages, en prere- 
glant la disposition des differents elements 
graphiques : en-tete, menus, formulaires, barres de 
navigation, zone d'affichage d'un article, zone de 
liens... 



Principe de fonctionnement 

L'objet Page Template definit une page avec du 
code XHTML valide, dont les elements peuvent 
porter des attributs speciaux charges d'effectuer 
des actions dynamiques. Ces attributs, du type 
tal : content, sont reconnus parce que la page 
indique (au niveau de la balise <html> ouvrante) 
I'espace de noms XML de TAL. 



Quelques fonctions TAL 

• tal : content 

• tal : define 

• tal : repeat 

• tal :condition 

• tal : attributes 

Les fonctions METAL 

• metal :define-macro 

• metal : use-macro 

• metal :define-slot 

• metal : fill -slot 

Pour la reference complete, voir I'annexe A sur ZPT. 
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Dans cet exemple, tal : content est un attribut 
HTML special fourni par une fonction TAL, et 
here/Title est une expression TALES. Dans 
cette expression, here est une variable implicite 
qui represente I'objet courant (ou contexte). 



Exemples d'utilisation de TAL 

Insertion d'une variable 

Prenons l'exemple simple suivant : 

<title tal :content="here/Title">Titre d'un document</title> 

Dans votre editeur HTML, cette balise affiche simplement « Titre d'un 
document ». En revanche, lorsque ce code est interprete par le serveur Zope, 
le titre de I'objet courant s'affiche dans la barre d'etat du navigateur (ce qui 
est le comportement fourni par la balise HTML <ti tl e>). 

Si le titre de I'objet est « Actualites », le resultat correspond au code HTML 
suivant : 

<ti tl e>Actual i tes</ ti tl e> 



Depuis Zope 2.7, vous pouvez utiliser context au 
lieu de here pour acceder au contexte courant. 



Definition de variables 

La definition de variables est possible avec l'attribut TAL tal : def i ne : 

<span tal :define="titre here/tit! e_or_id"> 

<hl tal :content="titre">titre</hl> 
</span> 

II est possible d'utiliser des expressions Python comme expression TALES : 

<span tal :define=" court python: here. title_or_id()[: 8] "> 

<h2 tal :content="court">Titre raccourci</h2> 
</span> 

Dans cet exemple, vous definissez et utilisez une variable locale court qui ne 
contient que les huit premiers caracteres du titre. 

Boucle 

Avec l'attribut tal : repeat, vous pouvez faire des iterations (boucles) : 
<ul> 

<li tal : repeat="obj here/objectVal ues"> 

<a tal :attributes="href obj/absolute_url" 
tal : content="obj/ti tl e_or_i d">ti tl e</a> 

</li> 
</ul> 
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La variable obj est l'objet actuel dans la boucle. L'URL de l'objet est affichee = 
dans la balise a avec l'attribut tal : attributes. Le titre de l'objet est affiche % 
dans le lien. § 

o 

I— 

<ul> °- 
<li> in 

<a href="http://localhost/docs/docl">Document 1</A> 

<a href="http://localhost/docs/doc2">Document 2</A> 

<a href="http://localhost/docs/doc3">Document 3</A> 
</li> 
</ul> 



Exemple d'utilisation de METAL 

Avec METAL, vous pouvez definir une macro sur un bloc de code au sein 
d'un template, afin de reutiliser ce bloc de code dans un autre template. Vbici 
un exemple : 

<html metal :define-macro="master"> 
<head> 

•ctitle tal :content="template/title">Le Titre</title> 
</head> 
<body> 

<h2xspan tal : replace="here/title_or_id">content title or id 
</span> 

<span tal :condition="template/title" 

tal : replace="template/title">optional template id 
</span> 
</h2> 

<div> Ceci est ma macro </div> 
</body> 
</html> 

Ici, l'expression define-macro="master" permet de definir la macro en la 
nommant master. 

Dans un autre template, defini au sein du meme conteneur, inserez le code 
suivant : 

<html metal : use-macro="container/macro_template/macros/master"> 
</html> 

Quand vous previsualisez le nouveau template en cliquant sur l'onglet Test de 
son interface, vous decouvrez le meme rendu qu'avec le premier template. De 
plus, la verification du code HTML produit en utilisant la commande 
Afficher la source du navigateur permet de prouver que le code correspon- 
dant a la macro a ete utilise dans le second template. 



Les langages TAL, TALES et METAL sont expli- 
ques en annexe A. 
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Mise en oeuvre 



//, Skin et sous-skins 

Une skin est une collection d'objets de presenta- 
tion et/ou de logique applicative permettant aux 
graphistes et aux developpeurs de construire et 
faire evoluer une interface utilisateur specialisee, 
sans alterer le code source du logiciel. Pour facili- 
ter cette gestion, une skin est organisee en objets 
conteneurs encapsulant les objets de presentation, 
et appeles layers ou sous-skins. 
Selon le contexte, le terme skin se traduit generale- 
ment par « habillage » ou « apparence ». 
En general, une sous-skin est chargee d'un aspect 
ou d'un besoin fonctionnel specifique : charte gra- 
phique, contenu, formulaires, logique de site 
(scripts), interface d'administration (« Control 
Panel »), etc. 



//. Moteur de skins 

Le systeme ou moteur de skins integre tout ce qui 
permet d'industrialiser la mise en ceuvre de Inter- 
face du site : les templates et les scripts, des outils 
d'analyse syntaxique et de creation de code HTML 
a la volee, des mecanismes d'optimisation (com- 
pression du code, gestion du cache), etc. 



Rappel 

Un script Python est un objet Zope permettant 
d'editer et d'executer du code Python via le Web. 



Pour reussir votre personnalisation graphique, il convient de comprendre 
comment fonctionne le systeme de skins de Plone, l'outil qui fournit la ges- 
tion de l'interface utilisateur. 

L'architecture de Plone (basee sur le CMF) integre un composant nomme 
porta"l_skins qui fournit les mecanismes de gestion d'une ou plusieurs 
skin(s). On peut l'appeler le « moteur de skins » de Plone. Une skin est com- 
posee de sous-skins, des conteneurs d'objets de presentation ou de logique 
applicative. Ainsi l'agregation de toutes les sous-skins disponibles fournit 
l'interface utilisateur du site. 

Vbus trouverez deux types de sous-skins au sein du composant portal_skins : 

• les objets de type File System Directory Vi ew, qui sont stockes sur le sys- 
teme de fichiers du serveur (dans le dossier /Products/CMFPl one/skins/), 

• les objets de type Folder, qui sont crees de toute piece via le Web par 
l'integrateur du site. Typiquement, la sous-skin nommee custom creee a 
l'installation de Plone et reservee pour votre personnalisation via le Web. 

Elements composant la skin "Plone Default" 

Plone est fourni avec la skin Plone Default, qui s'appuie principalement sur les sous-skins 
suivantes : 

• custom - Layer prevue par le CMF pour la personnalisation ; 

• gruf - Layer pour le produit Group User Folder ; 

• plone_ecmascript - Collection des JavaScript de Plone ; 

• plone_wysiwyg - Gestion des editeurs visuels ; 

• plone_prefs - Configuration des preferences de Plone ; 

• plone_portlets - BoTtes d'action ou d'information ; 

• pi one_templ ates - Templates qui assurent la structure des pages ; 

• plone_3rdParty/CMFTopic - Layer pour le produit CMFTopic ; 

• plone_styles - Feuilles de style (CSS) ; 

• plone_form_scripts - Scripts d'action des formulaires ; 

• pi one_sc ri pts - Scripts divers ; 

• pi one^forms - Formulaires ; 

• pi one_i mages - Images ; 

• plone_content - Presentation du contenu ; 

• cmf_l egacy - Layer avec quelques scripts CMF encore utilises par Plone. 



Chaque fois que l'utilisateur interagit avec un service du site (en visitant une 
page), le systeme parcourt une serie de sous-skins definies par le concepteur, 
jusqu'a trouver l'objet Zope a executer. S'il s'agit d'une methode ou d'un 
script qui fait appel a un autre objet, une nouvelle recherche est effectuee 
pour trouver cet objet, et ainsi de suite jusqu'a ce que la requete de l'utilisa- 
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teur soit satisfaite. La liste des sous-skins et l'ordre de priorite avec lequel la 
recherche s'effectue, sont determines a partir de deux parametres comple- 
mentaires : 

• La definition des sous-skins correspondant a chaque skin, faite par l'admi- 
nistrateur sous l'onglet Properties du composant porta"l_skins. C'est 
egalement la que l'administrateur definit la skin par defaut globale du 
site. 

* La skin de preference selectionnee par un membre du site via sa page 
d'options personnelles (ou preferences d'utilisateur). 

Ainsi, par defaut, les images, les scripts et les templates contenus dans la sous- 
skinzustom (en premiere position dans la chaine devaluation de la skin) sont 
toujours prioritaires sur les objets portant le mime nom mais contenus dans 
une sous-skin qui est positionnee en dessous (et done moins prioritaire). 



L'utilisation de CSS dans Plone 

Toutes les definitions de la CSS de Plone se trou- 
vent dans la /ayerplone_styles. Les fichiers les 
plus importants de ce repertoire sont pi one. ess 
et ploneCustom.css. 

Notez qu'il ne faut jamais modifier le fichier 
pi one . ess, mais que le travail s'effectue sur le 
fichier ploneCustom.css explicitement concu 
pour la personnalisation. 



Le gabarit des pages 



Presentation 

Le gabarit des pages est mis en oeuvre au sein du A?ffz^>/«&main_template, qui 
se trouve dans la .«w«-.f£zwplone_templates. Elle est tres technique et appelle 
un certain nombre de templates specialises, via le mecanisme des macros 
(METAL). 

La partie visuelle du gabarit est composee des principaux blocs suivants : 

• La barre de haut de page (ou top bar) - Elle contient les principaux ele- 
ments de marque tels que le logo, ainsi que l'interface de recherche et les 
liens vers les pages importantes du site (onglets vers les rubriques, actions 
personnelles de i'utilisateur, etc.). 

* Le bloc des trois colonnes - II permet d'afficher les trois colonnes corres- 
pondant a la zone de contenu (au centre) et aux barres laterales qui 
l'encadrent et qui contiennent les portlets ou « boites d'informations 
contextuelles ». Le systeme permet de reduire le nombre de colonnes a 2 
ou meme 1, en fonction de vos besoins. 

• La barre de bas de page (ou footer bar) - Elle contient des informations 
telles que le Copyright. Typiquement, si la place disponible le permet, on 
pourra y ajouter toute information ou lien complementaire que Ton veut 
faire apparaitre sur toutes les pages. 

* Le colophon - II contient des details sur les solutions utilisees pour met- 
tre le site en production, typiquement la fameuse phrase « Plone 
Powered » ou « Conforme a XHTML ». 



L'identifiant CSS de ce bloc est portal -top. 



L'identifiant CSS de ce bloc est portal -col umns. 



L'identifiant CSS de ce bloc est portal -footer. 



L'identifiant CSS de ce bloc est 
portal -colophon. 
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EXTRAIT DU GA8ARIT Le bloc « portal-top » 

<div id="portal -top" il8n:domain="plone"> 

<a href="#documentContent" class="hiddenStructure" 

il8n:translate="label_skiptocontent">Skip to content. </a> 
<a metal :use-macro="here/global_logo/macros/portal_logo"> 
The portal logo, linked to the portal root 

</a> 

<di v metal : use-macro="here/global_skinswitcher/macros/skin_tabs"> 
The skin switcher tabs. Based on which role you have, you 
get a selection of skins that you can switch between. 

</di v> 

<div metal :use-macro="here/global_siteactions/macros/ 
site_actions"> 

Site-wide actions (Contact, Sitemap, Help, Style Switcher etc) 
</di v> 

<di v metal : use-macro="here/global_searchbox/macros/quick_search"> 
The quicksearch box, normally placed at the top right 

</di v> 

<di v metal : use-macro="here/global_sections/macros/portal_tabs"> 

The global sections tabs. (Welcome, News etc) 
</di v> 

<di v metal : use-macro="here/global_group/macros/portal_group"> 

Portal group definition 
</di v> 

<div metal : use-macro="here/global_personal bar/macros/ 
personal_bar"> 
The personal bar. (log in, logout etc.) 
</di v> 

<div metal :use-macro="here/global_pathbar/macros/path_bar"> 

The breadcrumb navigation ("you are here") 
</di v> 
</di v> 

Pour la personnalisation, vous devez considerer main_template comme une 
boite noire qui fournit le support technique du gabarit des pages, et ne 
jamais la modifier (sauf cas ou besoin exceptionnel). 

II y a trois methodes differentes pour changer un aspect du gabarit, la struc- 
ture ou le comportement visuel des pages : 

• utiliser des proprietes bien placees telles que right_slots et left_slots 
(aucune ligne de code a ecrire) ; 

• utiliser CSS pour influencer le rendu d'un template appele par 
main_template ; 

• modifier le code ZPT/HTML d'un template appele par mai n_templ ate. 

II est recommande de tenter de respecter cet ordre lorsque vous recherchez 
comment modifier le comportement d'un bloc du site. 
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search 



home I I news 



you are here: home 



log in 



log in 



you are not logged in I log in '. join 



Welcome to Plone 



This welcome page is used to introduce you to the Plone Content 
Management System. 

You can customize this frontpage by clicking the edit tab on this document if you 
haye the correct permissions, Create folders and put content in those folders, 
Folders will show up in the navigation box if they are published. It's a very 
simple and powerful system, 

For more information: 

Q PIone website 

Q Zooe community 

-J lMF >'ebs te 

There are Q mailing lists and p recipe websites available to provide assistance 
to you and your new-found Content Management System. Q Online chat is also 
a nice way of getting advice and help. 

Please contribute your experiences at the Q PIone website 

Thanks for using our product. 

Q The Plone Team 
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Usable in any browser 



Figure 5-1 

Le gabarit, applique 
a la page d'accueil 



Exemples de personnalisation 



Supprimer les colonnes laterales 

Vous pourriez decider de modifier la structure du gabarit sur une page 
donnee, par exemple pour n'avoir que la colonne centrale. Par exemple, dans 
le cas de la page d'accueil, ce choix peut constituer une variation sur la page 
d'accueil classique d'un site Plone. 

Une page d'accueil a une seule colonne 

Pour changer le comportement de la page d'accueil afin que les colonnes 
laterales ne s'y affichent pas, il suffit de modifier l'objet index_html qui est 
utilise pour cette page, en lui ajoutant les deux proprietes right_slots et 
left_slots de type lines vides (ce qui correspond a une liste vide). Mais 
comment s'y prendre ? II y a une astuce ! 

En tant qu'administrateur, vous pouvez acceder aux interfaces de gestion 
technique des objets. Dans ce cas de figure, vous pouvez - meme si faction 
n'est pas exposee dans l'interface de Plone - acceder au formulaire de la 
ZMI {Zope Management Interface), qui permet de modifier les proprietes de 
l'objet i ndex_html (un objet Zope comme les autres). II suffit de visiter 
l'URL http://intranet/indexJitml/manage_propertiesForm, puis d'ajouter chacune des 
proprietes en question. 



IMPORTANT 



Les proprietes right_slots et left_slots 
doivent etre de type 1 i nes. 



RAPPEL « Inline CSS » 



Plone a prevu cette facon de faire et a reserve a 
cet effet, dans toutes les templates, une zone nom- 
mee css_s~lot dans laquelle on peut ajouter des 
regies CSS. Les regies ainsi ajoutees surchargent 
celles des principaux fichiers CSS (plone. ess et 
ploneCustom.css). 
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Des templates ne presentant pas de colonne laterale 

Vbus pouvez personnaliser un template specifique en utilisant des declara- 
tions CSS en ligne. 

Prenons une page de formulaire telle que login_form ou join_form, qui se 
trouve dans la jo^-^zwplone_forms, et dans laquelle nous ne voulons plus 
afficher les colonnes de droite et de gauche. II existe deux definitions dans le 
CSS qui nous permettent de cacher les colonnes: portal -column-one et 
portal -column-two. 

Done pour personnaliser ce template, dans la sous-skincustom, ajoutez le code 
suivant apres la balise ouvrante body : 

<tal : block metal :fin-slot="css_slot"> 
<styl e> 

#portal -column-one {display: none;} 
#portal -column-two {display: none;} 
</styl e> 
</tal :block> 

Des le rechargement de la page, vous pouvez verifier que les visiteurs ne 
voient plus les fameuses colonnes laterales. 

Modifier le contenu du bas de page 

Vbus pouvez redefinir le contenu de la zone de bas de page, en personnali- 
sant le template colophon contenu dans plone_templates. Remplacez, dans la 
version de personnalisation (dans custom), le code par defaut de Plone... 

<html xmlns=" http://www.w3 .org/1999/xhtml " 
xml :lang="en-US" lang="en-US" 
i 18n : domai n="pl one"> 

<body> 

<div id="portal -footer" metal :define-macro="portal_footer" 

i 18n : domai n="pl one"> 
<span il8n :translate="description_copy right" tal :omit-tag=""> 
Plone and its visual design is Copyright © 2000- 
<span il8n:name="current_year" 

tal :define="now modules/DateTime/DateTime" 

tal :content="now/year" /> 

by 

<span il8n:name="limi"> 

<a href ="http : //www. pi onesol uti ons . com">Al exander Li mi </a></ span> , 
<span il8n:name="runyaga"> 

<a href="http://www.runyaga.com">Alan Runyan</ax/span>, 
<span il8n:name="blacktar"> 

<a href="http://blacktar.com">Vidar Andersen</ax/span>. 

</span> 

</di v> 

</body> 

</html> 



par votre propre code, par exemple 



<html xml ns="http : //www.w3 .org/1999/xhtml " 
xml :lang="en-US" lang="en-US" 
i 18n : domai n="pl one"> 

<body> 

<div id="portal -footer" metal :define-macro="portal_footer" 
i 18n : domai n="pl one"> 
Copyright © 2003 - 

<span tal :define="now modules/DateTime/DateTime" 
tal : content="now/year"/> 

by Societe Geniale 
</di v> 
</body> 
</html> 

Voila ! Ainsi, vous obtenez un gabarit dont le bas de page est personnalise 
pour votre entreprise. 

La charte graphique 
Le logo de I'entreprise 

Nous allons maintenant remplacer le logo de Plone, qui se trouve dans 
pi one_i mages, par notre propre logo. La sous-skin custom ayant precedence 
sur la sous-skin pi one_i mages, si vous ajoutez dans custom une image portant 
le meme nom que le logo de Plone, c'est-a-dire logo, jpg, c'est cette nouvelle 
image qui sera affichee au sein du gabarit du site. 



RAPPEL Charte graphique 



C'est I'ensemble des elements et des concepts qui 
participent a definir I'identite visuelle du site : 

• couleurs, 

• fond de page, 

• typographic (polices), 

• elements graphiques : logo, icones, boutons. 
Elle definit egalement les regies de composition des 
pages. Elle doit etre bien etudiee afin de respecter 
les exigences d'ergonomie et d'accessibilite. 



Plone Skins Tool at /SocieteGeniale/ portal skins 



Skin selections 



r Plone Default 



Layers (in order of precedence) 



I - Plone Tableless 



Delete Save 



Add a new skin 
Name 



custom 
gruf 

plone_ecmascript 

plone_ Wysiwyg 

plone_pref s 

plone_portlets 

p lone_temp laces 

p lone_3 rdParty/ CHFTopic 



custom 
gruf 

p lone_ecmascr ipt 
plone_wysiwyg 
plone_ptef s 
p lone_port lets 
plone_ table less 
p lone_temp lates 



Layers 



Figure 5-2 Parametrage des sous-skins 



You can update the data for this image using the form 
below. Select a data file from your local computer by 
clicking the browse button and click upload to update the 
contents of the image. 



Si Image at 

/SocieteGeniale/portal skins /custom / logo. j p g 



Help! 



Title 



r 



Content Type |i ma ge/jpeg 
Preview 




P 1 © 0 



Last Modified 2004-03-02 08:21 



File Size 



6,998 bytes 

Save Changes 



Parcourir.. 



Upload | 



Figure 5-3 Ajout d'une image 
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ZOOM Arret sur le fichier plone.css 

Les liens sont definis dans plone.css par la 
declaration suivante : 

a { 

text-decoration : none; 
color : &dtml-linkColor; ; 
background-color: transparent; 

} 

Dans cette declaration, c'est la commande DTML 
&dtml-linkColor; qui permet d'inserer la 
valeur de la propriete linkColor. C'est la seule 
commande DTML que vous deviez connaftre pour 
modifier ploneCustom.css. 



Pour commencer, ouvrez le dossier custom et ajoutez-y un objet de type Image 
que vous nommez logo. jpg. Vbus devez telecharger vers le serveur le con- 
tenu du fichier image provenant du systeme de fichiers de votre poste. 

Rechargez ensuite la page d'accueil du site pour verifier que le nouveau logo 
est affiche. 



PLUS DE TECHNIQUE Avec CSS 

Vous pouvez avoir plus de controle sur I'image du logo en utilisant CSS. Par exemple, nous 
souhaitons appeler notre logo societegeniale.jpg. 

La premiere etape consiste a renommer notre logo, jpg, deja situe dans la /ayercustom, 
en societegeniale.jpg. 

En regardant le code HTML de la page d'accueil de Plone, vous remarquerez que le logo 

I ogo . j pg n'est pas indique. 

<hl id="portal -logo"> 

<a h ref =" http : /f\ ocal host : 8080/P1 one">Portal </a> 
</hl> 

II va ensuite falloir que vous recherchiez la declaration portal -logo, qui permet d'afficher 
le logo. La partie de plone.css qui est specifique pour I'affichage du logo est la suivante : 

/* Logo properties */ 
#portal-logo { 

background: url (&dtml-portal_url ;/&dtml-logoName;) no-repeat; 
border: 0; 

margin: 0.75em Oem 0.75em 1.5em; 
padding: 0; 

} 

Allez maintenant dans I'objet base_properties (qui se trouve probablement deja dans 
custom) et changez la valeur de la propriete logoName en societegeniale.jpg. Vous 
remarquez alors que notre logo est toujours affiche sur la page d'accueil de Plone, mais 
qu'il s'appelle soci etegeni al e . j pg. 



Autres exemples de personnalisation 
Changer les couleurs 

Les couleurs de Plone sont definies, en meme temps que certaines autres 
caracteristiques, dans une page de proprietes nommee base_properties, que 
Ton trouve dans la layer plone_styles. 

Pour changer ces proprietes, cliquez sur I'objet base_properties, selectionnez 
custom comme destination et validez en cliquant sur Customize. Vbus venez 
done faire une copie exacte de basejroperties dans le dossier custom, ce qui 
va vous permettre de l'editer. 

Nous allons maintenant changer la couleur des liens en modifiant la pro- 
priete linkColor. 
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M Filesystem Properties Object at /SocieteGeniale/portal skins/plone styles/ base properties 



Id base_properties 

Source fife CMFPlone\skins\plone_styles\base_properties, props 

Customize Select a destination folder and press the button to make a copy of these properties that can 
be customized. 
| custom _J Customize | 



title 

plone_skin 

logoName 

fontFamily 

fontBaseSize 

fontcolor 

fontSmallSize 

backgroundColor 

linkColor 

NnkActiveColor 

MnkVisitedColor 

borderWidth 



jPlone's color, font, logo and border defaults 




string 
string 
string 



Lucida Grande", Verdana, Lucida, Helvetica, Arial, sans-serif | stm 9 

string 



|69% 
Black 

\as% 

[white 




string 
string 
string 
string 
string 
string 
string 



Figure 5-4 

L'objet base_properties 



Q Folder at /SocieteGeniale/portal skins/custom/ base properties 

Properties allow you to assign simple values to Zope objects. To change property 
values, edit the values and click "Save Changes". 



Name 
r title 

r~ plone_skin 

f logoName 

r~ fontFamily 

r~ fontBaseSize 

I - fontcolor 

r fontSmallSize 

r~ backgroundColor 

□ linkColor 

£j linkActiveColor 



Value 



Type 



■ 



|Plone's color, font, logo and border defaull str|n g 
|Plone Default ~| strin 9 

|logo.jpg string 
"Lucida Grand e", Verdana, Lucida, Helvet strin g 

string 
string 
string 
I string 
string 
I string 



Black 



#436976 



[Red 



Figure 5-5 

Personnalisation de l'objet 
base_properties 



Pour obtenir une couleur plus vive, remplacez la valeur par defaut de 
linkColor (#436976) par #3399CC, dans l'objet base_ _properties. 

Changer les polices de caracteres 

Vbus pouvez facilement personnaliser les polices de caracteres, les couleurs, 
le logo et d'autres elements CSS dans une page de proprietes (Property Sheet) 
utilisee par la CSS de Plone. 



Pour changer les polices de caracteres utilisees par Plone, il suffit de modifier 
les proprietes fontFamily et headingFontFamily. 

La propriete fontFamily est utilisee dans la declaration CSS du body : 
body { 

font: &dtml-fontBaseSize; &dtm~l-fontFamily ;; 
background-color : &dtml -backgroundColor; ; 
color: &dtml -fontcolor; ; 
margin : 0 ; 
padding: 0; 

} 

La propriete headingFontFamily est utilisee pour les en-tetes des pages du site 
Plone : 

hi, h2, h3, h4, h5, h6 { 

font-family: &dtml -headingFontFamily; ; 
color: &dtml -fontcolor; ; 
background-color : transparent; 
font-size: &dtml-headingFontBaseSize; ; 
font-weight: normal; 
margin : 0 ; 
padding-top: 0.5em; 

border-bottom: &dtml-borderWidth; &dtml-borderStyle; &dtml- 
global BorderColor; ; 
} 

Aim d'obtenir une police de caracteres personnalisee, nous allons remplacer 
la valeur des proprietes fontFamily et headingFontFamily par la valeur Arial , 
Geneva, Helvetica, Verdana, Sans-Serif;. 

Vbus pouvez alors constater que tous les textes et les en-tetes des pages de 
Plone sont affiches avec notre propre famille de polices de caracteres. 

La page d'accueil 
Par defaut 

A la creation initiale d'un site Plone, un document (c'est-a-dire un contenu 
de type Document) est cree a la racine pour fournir le contenu de la page 
d'accueil. Ce document est nomme indexjitml, ce qui est necessaire au fonc- 
tionnement de cette configuration. 

Ainsi, il vous suffit de modifier ce document pour y ajouter votre texte 
d'accueil personnalise. Mais vous aurez une page d'accueil assez pauvre en 
termes de services ! En effet, en tant qu'objet de type Document, celle-ci ne 
peut recevoir que du texte « statique ». 



Enrichir la page 

Vous avez la possibilite d'enrichir cette page avec du contenu dynamique - 
apres tout, un serveur d'application, 9a sert a 9a - que vous injectez dans une 
zone bien choisie, par exemple sous le texte d'accueil. 

Pour obtenir cette nouvelle page, vous devez personnaliser le tem- 
j6/afedocument_view responsable d'afficher le contenu d'un objet de type 
Document. Ce template se trouve dans la ^o«^-^/«plone_content. Visitez-la, 
puis en utilisant le bouton Customize expose dans l'interface, creez la nou- 
velle version dans laquelle vous ajouterez, au bon endroit, le bloc de code 
suivant : 



Pour aller au bout. 



II ne restera plus qu'a y inserer du code capable 
d'injecter le contenu dynamique, typiquement, du 
code de requete sur le portal_catalog. Voir le 
chapitre suivant pour les differentes techniques 
pour produire du contenu dynamique au sein d'un 
template. 



<div tal :omit-tag="" 

tal : condi ti on="python : contai ne r . meta_type== ' PI one Si te ' 
and here.getldO == 'indexjtml '"> 
<hl> Nouveautes de 1 'intranet </hl> 
<! — Zone reservee au code du contenu dynamique — > 
</div> 

II faudra egalement faire quelques modifications mineures ou d'ordre 
« cosmetique » dans le code initial pour obtenir la bonne presentation pour 
votre page d'accueil. Le code complet resultant de ces differentes modifica- 
tions devrait ressembler a ce qui suit : 

<html xm~lns="http://www. w3.org/1999/xhtml" xml :lang="en" 
lang="en" 

metal : use-macro="here/main_templ ate/macros/master" 
il8n:domain="plone"> 

<body> 

<metal : mai n fi 11 -slot="mai n"> 

<tal :main-macro metal :define-macro="main" 

tal :define="len_text python:len(here.text) ; "> 

<hl tal :content="here/title_or_id" class="documentFi rstHeading"> 
Title or id 

</hl> 

<div metal :use-macro="here/document_actions/macros/ 
document_actions"> 
Document actions (print, sendto etc) 

</div> 

<di v class="documentDescri ption" 

tal :content="here/Description"> 
descri ption 

</div> 

<p tal : condi tion="python: not len_text and is_editable" 
i 18n : transl ate="no_body_text" 
class="discreet"> 

This item does not have any body text, click the edit tab 
to change it. 

</p> 



Le titre du document ou de la page. 



La description du document. Peut etre utilisee 
pour la phrase qui introduit le site intranet. 
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La gestion de I'affichage du contenu (statique) 
du document. 



Enfin, le bloc qui va fournir du contenu dynami- 
que dans la page d'accueil. 



Nous ajoutons ici un traitement conditionnel ► 
avec le tal condition pour que I'element 
« byline » ne soit pas pris en compte dans le cas 
de la page d'accueil. 



<div class="stx" 

tal :condition="len_text" 

tal : attri butes="cl ass python : test (here . text_f ormat== 
^♦'structured-text' , 'stx', 'plain')"> 
<div tal : replace="structure 

python: here. CookedBody(stx_level =2)" /> 

</di v> 

<div tal :omit-tag="" 

tal :condition="python:container.meta_type=='Plone Site' 
and here.getldO == 'index_html '"> 
<hl> Nouveautes de 1 'intranet </hl> 
<!-- Zone reservee au code du contenu dynamique --> 
</di v> 

<div tal :omit-tag="" 

tal :condition="not: python :container.meta_type==' PI one Site' 

and here.getldO == 'index_html '"> 
<div metal :use-macro="here/document_byline/macros/byline" > 
Get the byline - contains details about author and 
modification date. 
</di v> 
</di v> 

</tal :main-macro> 
</metal :main> 
</body> 
</html> 



AUTRES ELEMENTS Les actions 

Les actions sont des objets de parametrage qui permettent d'ajouter des elements d'inte- 

raction (liens, boutons, onglets, actions « javascript », etc.) a I'interface utilisateur. 

Le composant portal _actions fournit un service de gestion des actions afin de faciliter la 

personnalisation du site et sa maintenance. Les actions sont parametrables soit au niveau 

de chaque type de contenu, soit au niveau d'un composant qui respecte le contrat 

d'Action Provider vis-a-vis de portal_actions, soit au sein de portal_actions lui- 

meme. 



En resume... 

Maintenant que votre site est a vos gouts et a vos couleurs, il reste le plus 
important : personnaliser son fonctionnement, pour qu'il fonctionne vrai- 
ment comme vous le souhaitez et que les utilisateurs de l'intranet puissent 
enfin y participer ! C'est precisement l'objet des prochains chapitres. . . 
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Les workflows 




SOMMAIRE 
Introduction aux workflows 
Regies de publication 

► Workflow et securite 

► Encore plus d'automatisation ! 

MOTS-CLES 

Workflow 

► Securite 

► Publication 



Workflow | securite | publication 




rejeter 




retirer 



II est possible d'aller beaucoup plus loin dans la configuration que ce que nous 
avons vu precedemment - et c'est la toute la force de Plone par rapport a d'autres 
outils de gestion de contenu. Nous allons presenter maintenant comment confi- 
gurer tres precisement les regies de publication des documents. 



Introduction aux workflows 



Par defaut, un document nouvellement cree par un 
contributeur est a I'etat visible. Nous verrons 
plus loin dans ce chapitre qu'il est possible de 
changer I'etat par defaut d'un workflow. 



Comme nous l'avons explique dans les precedents chapitres, un utilisateur 
authentifie a la possibilite de placer du contenu dans son espace personnel. 
Pour ce qui est de la publication, il doit s'en remettre a un responsable 
(appele relecteur) qui va decider du bien-fonde ou non de sa demande. Ces 
regies, qui jusqu'a present nous ont paru quelque peu empiriques, sont regies 
par un workflow. Avant de proposer une definition « scientifique » de la 
chose, voyons ce quest, au juste, un workflow. 

Les etats 

Jusqu'a present, vous avez pu constater qu'un document du site pouvait etre 
dans un « etat » particulier : 

• prive (ou private) ; 

• visible (identique en anglais) ; 

• en attente (ou pending) ; 

• public (identique en anglais). 

Ces etats sont mutuellement exclusifs : un document est dans un et un seul 
etat a la fois, mais peut prendre plusieurs etats au cours de son existence. 

Intuitivement, on peut dire que chaque etat definit « qui peut faire quoi » sur 
le document. On peut ainsi imaginer une matrice qui resumerait la fonction 
precise de chaque etat : 



Tableau 6-1 Tableau des permissions affectees a chaque etat 



Etat 


Qui peut lire ? 


Qui peut ecrire ? 


Prive 


Le proprietaire du document 
L'adminitrateur du site 


Le proprietaire du document 
L'adminitrateur du site 


Visible 


Tout le monde 


Le proprietaire du document 
L'administrateur du site 


En attente 


Tout le monde 


Les relecteurs concerned 
L'administrateur du site 


Public 


Tout le monde 


L'administrateur du site 



Ce tableau permet d'avoir une vision plus claire des droits affectes a chaque 
etat d'un document. 

Un etat est done avant tout une expression des restrictions de securite 
s'appliquant a un document. Changer un document d'etat permet de lui 
affecter d'autres regies de securite : par exemple, passer de I'etat prive a I'etat 
visible permet aux utilisateurs anonymes du site de visualiser le document 
- ce qu'ils n'avaient pas le droit de faire lorsque celui-ci etat a I'etat prive. 
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La securite dans Zope 

Avant d'aller plus loin dans notre etude des workflows, il est indispensable de 
poser les bases de la securite sous Zope. 

Les principes de base 

Nous avons decouvert, dans les chapitres precedents, les notions de « roles ». 
Dans Zope (ces notions ne sont pas particulieres a Plone), la securite est dis- 
tribuee grace a trois concepts interdependants : 

• utilisateurs ; 

• roles ; 

• permissions. 



3 Intranet de la 


Societe Geniale - Wanadoo 














Fichier Edition 


Affkhage Favoris Outils ? 












I © 


Ad/esse http://book,ingenidev/manage_aci:ess 
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15 


Set Group Ownership 


r 


r 


r 


r 


r 


r 




17 


Set own password 


r 


r 


17 


17 


r 


r 




Acquire? 




Anonymous 


Authenticated 


Manager 


Member 


Owner 


Reviewer 




17 


Set own properties 


r 


r 


17 


17 


r 


r 




17 


Take ownership 


r 


r 


r 


r 


r 


[j 




17 


Test Database Connections 


r 


r 


r 


r 


r 


r 




17 


Undo changes 


r 


n 


17 


r 


17 


n 




17 


Use Database Methods 


r 


r 


r 


r 


r 


r 




17 


Use Factories 


r 


n 


r 


r 


r 


n 




17 


Use rnailhost services 


r 


r 


r 


r 


r 


r 




17 


View 


r 


n 


r 


r 


r 


r 




17 


View Groups 


r 


r 


n 


r 


r 


r 




17 


View History 


r 


r 


r 


r 


r 


r 




Acquire? 




Anonymous 


Authenticated 


Manager 


Member 


Owner 


Reviewer 




17 


View admin topic 


r 


r 


r 


r 


r 


P 




17 


View management screens 


r 


r 


17 


r 


17 


r 




17 


WebDAV Lock items 


r 


r 


r 


r 


r 


r 




17 


WebDAV Unlock items 


r 


n 


r 


r 


r 


n 




17 


WebDAV access 


p 


r 


r 


r 


r 


r 





Save Changes | 

You can define new roles by entering a role name and clicking the "Add Role" button. 
User defined roles 



NouveauRole 



| Member ^| 



Internet 



Figure 6-1 Notions d'utilisateur, de role et de permission 

Comme nous le voyons, un utilisateur possede un certain nombre de roles ; a 
chaque role est affecte une liste de permissions. Si un utilisateur possede un 
role, il aura done toutes les permissions accordees a ce role. Si un utilisateur 
possede plusieurs roles, toutes les permissions de chaque role lui seront 
accordees. 
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A RETENIR 

Un role est cree a partir d'un niveau precis de 
I'arborescence de Zope, et est valable pour tous les 
sous-niveaux de cette arborescence. Autrement 
dit, si vous creez un role NouveauRoie au niveau 
de votre site Plone, ce role n'existera pas dans la 
racine de votre site Zope. 



Attention 

Ne supprimez jamais les roles par defaut de 
Plone! Les roles Member et Reviewer sont 
indispensables a son bon fonctionnement ! 



Les roles 

Dans Plone, nous rencontrerons essentiellement les roles suivants : 

• Manager - C'est le role de l'administrateur du site. Par defaut, un utilisa- 
teur dote du role Manager a le droit de « tout faire », un peu comme l'utili- 
sateur root sur Unix. Pour eviter les derives, il convient de n'attribuer ce 
role qu'avec parcimonie et discernement ! 

• Reviewer - Appele en francais Reiecteur », il s'agit du role que possedent 
les membres du site charges de valider le contenu (notamment de valider 
le contenu place a i'etat En attente). 

• Member - Role de base d'un membre d'un site Plone. Un utilisateur ne 
pourra pas contribuer correctement a un site Plone s'il n'est pas dote de 
ce role. 

• Owner - Ce role est tres particulier : il est attribue automatiquement a un 
contributeur lorsqu'il cree un objet, mais uniquement sur l'objet qu'il a 
cree, et non pas sur l'ensemble du site. II s'agit d'un « role local », c'est-a- 
dire d'un role attribue a certains utilisateurs uniquement pour certains 
objets. Nous decrirons ce mecanisme plus loin dans cette section. 

En dehors de ces quatre roles par defaut, il vous est tout a fait possible de 
creer de nouveaux roles. Pour cela, il convient de se rendre dans l'interface 
d' administration de Zope (ou la ZMI), via l'URL suivante : http:// 
localhost:8080/manage. Puis, allez dans le Folder correspondant a votre site Plone 
et cliquez sur l'onglet Security. Tout en bas de la page (et quelle page !), vous 
trouverez une zone d'edition permettant de saisir le nom du nouveau role. 
Cliquez sur Add Role, et ce role est cree pour tout le site Plone. Inversement, 
le bouton Delete Role vous permet de supprimer les roles que vous auriez deja 
crees. 

Nous verrons plus loin une autre notion, appelee « Role local », qui permet 
d'etendre ce modele. 

Les permissions 

Sous Zope, une permission est, dans son acception la plus rigoureuse pos- 
sible, une chaine de caracteres associee d'une part a des methodes de classes 
Zope et d'autre part a des roles. Une methode ne peut etre appelee par un 
utilisateur que s'il possede un role qui lui autorise la permission associee a la 
methode. 

Plus simplement, une permission definit un droit a une action. Par exemple, 
sous Plone, la consultation d'un document est soumise conjointement aux 
permissions Access contents information et View. La modification est sou- 
mise a la permission Modify Portal Content. 
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Utilisateurs et groupes 

Les deux derniers concepts a aborder avant de se plonger dans la securite de 
notre intranet sont les utilisateurs et les groupes. Un utilisateur est une 
personne : rien de plus simple a imaginer ! 

A chaque utilisateur peuvent etre affectes des roles (mais jamais de permis- 
sions individuelles). 

Sous Plone (grace a l'outil Croup User Folder appele aussi GRUF), les groupes 
ne sont « que » des utilisateurs particuliers. lis possedent done des roles. Un 
utilisateur, dans l'interface de GRUF, peut etre affecte a un (ou plusieurs) 
groupe(s), et ainsi « heriter » des roles de ces groupes. De meme, un groupe 
peut appartenir a un (ou plusieurs) groupe(s), permettant ainsi de produire 
des organisations d'utilisateurs tres completes. 

Retroussez vos manches : il est temps maintenant de se plonger dans la crea- 
tion de ces groupes ! 

Comme nous l'avons vu plus haut, nous limitons notre analyse a trois 
populations : 

• Marketing ; 

• Service Apres-Vente ; 

• Direction Generale. 

Une rapide analyse nous permet d'anticiper que chacune de ces populations 
va faire l'objet d'un... groupe, et que le groupe Di rection Generale aura pro- 
bablement quelques droits supplementaires par rapport aux autres groupes. . . 

Mais n'anticipons pas : si vous n'avez pas encore cree ces groupes, e'est le 
moment de le faire. Ouvrez l'interface de Plone en tant qu'administrateur et 
cliquez sur le lien Configurer Plone, puis sur Users and Groups administration. 
Un magnifique panneau recapitulatif apparait, avec un onglet Users et un 
onglet Groups. Par defaut, l'onglet Users est ouvert, comme sur la page ci- 
apres. 

Cliquez sur l'onglet Groups puis sur le bouton Add new group, afin de creer les 
trois groupes dont nous aurons besoin : 

• marketi ng ; 

• support ; 

• dg. 

II n'est pas necessaire de remplir tous les champs (en particulier l'adresse 
electro nique). 

Puisque nous y sommes, il est egalement interessant de creer quelques utili- 
sateurs pour manipuler le site : cliquez sur le bouton Add new user de l'onglet 
Users, remplissez les champs du formulaire, et voila ! II ne nous reste plus 
qua affecter ces utilisateurs a des groupes. 



Attention 

II est parfois tentant, dans certains projets, de 
« mutualiser » des comptes utilisateurs, e'est-a- 
dire de donner le meme nom de compte et le 
meme mot de passe a plusieurs personnes pour 
des raisons de simplicity. Ceci est a proscrire 
formellement en Plone, ou le compte utilisateur 
revet une grande importance ! 



Sous Plone, le role minimum d'un utilisateur est 
Member. Un utilisateur qui n'est pas dote de ce 
role ne pourra probablement pas utiliser Plone cor- 
rectement. 
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Click the User Name to see and change the details of a specific user, or click 
the envelope to send a mail, You can edit the and e-mail address and remove 
users directly from this form. You can also access the user registration form to 
add new users. 
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Figure 6-2 Gestion des utilisateurs dans Plone 

Retournez a l'onglet Groups, cliquez sur un groupe de votre choix (par 
exemple dg), puis sur l'onglet group members de la page qui apparait. Vous 
obtenez une interface presentee comme a la figure 6-3. 

La premiere partie de la page est une interface de recherche, vous permettant 
de choisir les membres que vous voulez associer a ce groupe, tandis que la 
partie du bas vous permet eventuellement de supprimer ces utilisateurs des 
groupes. Affectez les utilisateurs que vous souhaitez aux groupes que vous 
souhaitez, rien de plus facile ! 
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Groups Management 



Groups are logical collections of users, like departments and business units. 
They are not directly related to permissions on a global level, you normally use 
Roles for that - and let certain Groups have a particular role, 
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Roles Management 



Roles are collections of permissions, The most common role is the Member role, 
which is any member of the portal. You can define additional roles, but you 
normally only do that when you need to create a new discrete unit of 
permissions that you can combine to make up a Group, 

Currently, if you want to add a new role, you'll have to use the Zope 
fcj (6 elements restant(s)) Telechargement de I'image http://book,ingenidev/clouds,png,,. 
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Figure 6-3 Gestion des groupes dans Plone 



Workflows et type de contenus 

Apres cette incursion dans la securite sous Zope, voyons maintenant quel est 
le rapport entre cette securite et les workflows. 

Sous Plone, done, un contenu peut prendre plusieurs etat. A chacun de ces 
etats correspond un ensemble de permissions associees a un ensemble de 
roles. Un etat est done avant tout un snapshot (une photographie) des per- 
missions sur un contenu. 

Chaque fois que Ton fait changer un document d'etat, on lui applique les 
permissions associees a ce nouvel etat. 

La regie de base des workflows est qua un type de contenu est associe un et 
un seul workflow. Nous allons, dans les sections qui suivent, regarder a quoi 
servent les workflows, comment les creer et les modifier. 
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You can add or remove users from this particular group here. Note that this 
doesn't actually delete the user, it is only removed from this group. 

Search for new group members 
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Figure 6-4 Affectation d'utilisateurs a des groupes 



L'outil portal workflow 

Placez-vous dans l'interface d'administration de Zope, sur l'outil 
portal_workflow. Vous pouvez alors consulter l'interface suivante. 

Associer un workflow a un type de contenu 

En face de chaque type de contenu, on peut saisir le nom d'un workflow 
associe. Si la chaine (Default) est utilisee pour un type de contenu, alors le 
workflow mentionne a la section (default) est utilise. En standard dans 
Plone, il existe deux workflows : 

• folder_workflow - II s'agit d'un workflow particulierement adapte aux 
dossiers, comme son nom l'indique. II possede trois etats : visible, 
published et private. 
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Figure 6-5 L'interface de selection des workflows par type de contenu 

• plone_workflow - Ce workflow et plus adapte aux types de contenu tradi- 
tionnels et possede un niveau de moderation. Ainsi, il expose les etats 
private, visible, pending et published. 

II est possible, en remplacant un champ par le nom d'un workflow valide, 
d'utiliser ce nouveau workflow pour un type de contenu donne. Par exemple, 
vous pouvez decider que les types de contenu Image respecteront desormais 
un workflow de type folderjvorkflow en lieu et place de plone^workflow. 

Les dossiers restreints 

Voyons maintenant le detail de chaque worfklow. Cliquez sur l'onglet 
Contents, puis sur le premier workflow. Plusieurs onglets apparaissent, en 
particulier States et Transitions, qui vous donnent un apercu des etats et tran- 
sitions applicables pour ce workflow. 

Cliquez sur l'onglet States. Les trois etats du workflow apparaissent clairement. 
En face de letat vi si bl e, une asterisque indique qu'il s'agit la de 1 etat par defaut, 
c'est-a-dire letat que prend automatiquement un contenu a sa creation. 



Attention 

Nous I'avons vu, un etat d'un workflow est une 
sorte de photographie des permissions appli- 
quees a des contenus. Si vous changez de work- 
flow pour un type de contenu donne, il faut 
remettre a jour la securite sur le site ! De meme, 
il se peut que certains contenus se trouvent 
dans des etats qui n'existent plus dans le nou- 
veau workflow. II faut alors leur faire prendre un 
etat « par defaut » et surtout en appliquer les 
permissions. 

Pour realiser cette operation, chaque fois que 
vous modifiez des workflows, cliquez sur le bou- 
ton Update security settings. Cette etape est 
indispensable pour appliquer vos modifications 
a tous les contenus deja presents sur le site. 
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Attention 

Lorsque Ton modifie un workflow, c'est genera- 
lement une mauvaise idee de supprimer des 
etats. II vaut mieux conserver un etat et suppri- 
mer toutes les transactions qui menent vers cet 
etat. 



Dans notre exemple de site, nous allons modifier le workflow pour prendre 
en compte un nouvel etat, « restreint » (restricted pour conserver l'angli- 
cisme des etats deja existants). II ne s'agit pas d'une modification anodine et 
cela reclame un maximum de concentration ! Allons -y, etape par etape... 

Pour resumer notre cas d'utilisation, nous voulons que toutes les rubriques 
soient visibles par defaut a tous les membres du site, mais que certaines 
rubriques soient visibles uniquement a certains membres, que nous devrions 
pouvoir definir rubrique par rubrique. Une fois qu'une regie d'acces est eta- 
blie pour une rubrique, elle est valable pour toutes ses sous-rubriques. Nous 
souhaitons conserver les etats visible, private et published. II sera cepen- 
dant necessaire d'appliquer quelques modifications a ces trois etats pour 
rendre notre systeme parfaitement operationnel. 

Attachons-nous en premier lieu a etudier la securite des etats published et 
visible. Bien que leur semantique soit differente, ces deux etats doivent 
dans notre schema etre porteurs des memes permissions. De meme, ils doi- 
vent etre configures de maniere a ce que si un dossier est visible ou 
published au sein d'un dossier restricted, ces dossiers publies « heritent » 
des restrictions de securite du dossier qui les contient, et soient done res- 
treints eux aussi. La notion d'acquisition va nous etre fort utile ! 

Cliquez sur l'etat visible. Une nouvelle page de proprietes apparait, avec un 
onglet Permissions : c'est celui-ci qui nous interesse ici. 



Figure 6-6 

La page « Permissions » 
de l'etat « Visible » 
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Workflow State at /Plone/portal workflow /folder workflow/states/ visible 

When objects are in this state they will take on the role to permission mappings defined below. Only the permissions managed by this 
workflow are shown. 
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Save Changes 
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Tel qu'il est configure par defaut dans Plone, cet etat pose un petit souci : en 
effet, certaines permissions sont systematiquement accordees au role 
Anonymous (c'est-a-dire aux utilisateurs anonymes), quel que soit I'etat du 
dossier qui les contient. Cela va a l'encontre de la regie que nous nous 
sommes fixee, qui stipule qu'un dossier publie dans un dossier restreint doit 
etre restreint lui-aussi. II faut done oter aux anonymes cette permission, et se 
baser uniquement sur l'acquisition des permissions pour autoriser l'acces a 
un dossier. Placez done les permissions comme presentees dans le tableau 
suivant : 



Acq. Perm, 
settings 




Anonymous 


Authenticated 


Manager 


Member 


Owner 


Reviewer 


X 


Access contents information 






X 






X 


X 


List folder contents 






X 




X 




X 


Modify portal content 






X 




X 




x - 


View 






X 






X 



Sauvegardez les permissions ainsi affectees. Allez sur I'etat published et 
appliquez strictement le schema precedent. Ici encore, il convient essentiel- 
lement de retirer la case Anonymous. 

L'etat private n'appelle pas de commentaire particulier. Nous ne nous y 
attarderons pas. II convient maintenant de creer le fameux etat restricted, 
mais... avant cela, une question subsiste. Comment indiquer a Plone quels 
sont les utilisateurs qui ont acces a un dossier restreint ? Le meilleur moyen 
(et probablement le seul !) consiste en l'utilisation de roles locaux. Aucun 
role, par defaut, ne correspond vraiment a l'usage que nous souhaitons en 
faire. Aussi convient-il de creer un role a la racine du site. Placez-vous sur 
l'objet Plone Site et cliquez sur l'onglet Security. Tout en bas de la page, dans 
le formulaire, creez un role appele Local Viewer et validez. 

Retournez dans le workflow du dossier, sur la page States, et dans la zone Add 
a state, creez notre fameux etat restricted. Avant de remplir les autres pro- 
prietes, placez-vous sur l'onglet Security de ce nouvel etat et appliquez les 
permissions presentees dans le tableau ci-dessous. Vous noterez au passage 
l'apparition du role Local Viewer dans le tableau ! 



Acq. Perm, 
settings 




Anonymous 


Authenticated 


LocalViewer 


Manager 


Member 


Owner 


Reviewer 




Access contents information 
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X 


X 




List folder contents 
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Modify portal content 
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View 
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X 




X 


X 



Les permissions de Plone 

Usuellement, dans Plone, nous travaillons avec 
les permissions suivantes : 

• Access contents information - Cette 
permission regit l'acces a de nombreuses pro- 
prietes du contenu, comme son titre, son 
auteur, sa date de derniere modification, etc. 

• List folder contents - Cette permis- 
sion s'applique a la methode de listing des 
objets contenus dans un dossier. 

• Modify portal content - Cette permis- 
sion permet de modifier un contenu. 

• View- Cette permission permet de voir le 
contenu « brut ». Elle n'est pas suffisante 
pour afficher un contenu complet dans une 
page : elle doit etre associee a Access 
contents information. 
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Figure 6-7 

Creation du role Local Viewer 
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Save changes | 

You can define new roles by entering a role name and clicking the "Add Role" button 
User defined roles 



|LocalViewer 
I Member H 



Add Role 



Termine 
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Ici, toute l'astuce consiste a supprimer les cases Acqui re permission settings 
pour les permissions que nous souhaitons reellement restreindre. Et le tour 
est joue ! Apres avoir valide, cliquez sur l'onglet Properties de l'etat, rem- 
plissez son titre et sa description avec un texte susceptible de vous rappeler, 
dans un an, a quoi sert cet etat ! :-) 

Ne quittez pas la page de proprietes : la zone Possible transitions nous rappelle 
qu'un etat sans transitions est aussi utile qu'une bouteille sans tire-bouchon. 

Afin de savoir quelles transitions permettre a partir de quel etat, voici un 
petit recapitulatif : 

• etat private : publish, show, restrict ; 

• etat published : hide, retract, restrict ; 

• etat restricted : show, hide, publish, retract ; 

• etat visible : hide, publish, restrict. 

Cochez done les cases show, hide et publish pour les transitions possibles a 
partir de l'etat restricted. Pour modifier les autres etats, il faut avant tout 
creer la transition restrict, qui n'existe pas encore. Allez sur l'onglet Transi- 
tions du workflow et creez, en bas de la page, la nouvelle transition appelee 
restrict. Utilisez les informations fournies dans la figure suivante. 
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Workflow Transition at /Plone/portal workflow /folder workflow/transitions/ restrict 

restrict 



Version Control 



id 

Title 

Description 



Destination state 
Trigger type 



jlvlember makes content restricted 




restricted 
C Automatic 
G Initiated by user action 
<" Initiated by WorkflowMethod 



Script (before) 
Script (after) 
Guard 



|(None)_3j 
|(None)2j 
Permission(s) | 
Expression 

Display in actions box Name (formatted) | RBStreindrB 



Role(s) | Owner 



URL (formatted) |%(content_url)s/content_show_form 
Category | workflow 



Save changes 
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Vbici une explication de chacun des champs : 

• Id : l'identifiant de la transition ; 

• Title : un titre pour la transition, qui n'apparaitra pas a l'utilisateur final ; 

• Description : une description succincte du role de Taction ; 

• Destination state : etat de destination de la transaction (restricted dans 
notre exemple) ; 

• Trigger type : type de declenchement de la transition ; 

• Scripts : scripts Python qui peuvent etre declenches avant ou apres l'exe- 
cution de la transition (nous verrons plus loin dans ce chapitre leur 
grande utilite) ; 

• Guard : permissions et/ou roles et/ou expression TAL a verifier pour que 
la transition soit proposee a un utilisateur (dans notre cas, il faut simple- 
ment qu'un utilisateur possede le role owner sur le dossier pour pouvoir 
appliquer la transition, mais nous pourrions imaginer des schemas plus 
complexes) ; 



Figure 6-8 

Les proprietes de la transition restrict 



L'etat de destination d'une transaction 

Sous Plone, une transaction est definie par son 
etat de destination et non pas son etat d'ori- 
gine. Ainsi, une meme transaction peut etre uti- 
lise* depuis plusieurs etats mais ne peut mener 
qu'a un et un seul etat. 
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• Display in actions box : titre de Taction, tel qu'il apparaitra a l'utilisateur 
final. Sous Plone, le champ URL n'est pas utilise, et le champ Category doit 
toujours avoir pour valeur workf i ow. 

Et voila ! Notre transition est creee. Ajoutez la transition restrict aux etats 
vi si bl e, pri vate et pubi i shed de maniere a pouvoir rendre un dossier restreint. 

II ne reste plus qua cliquer, comme nous l'avons vu ci-dessus, sur le bouton 
Update security settings de la page d'accueil de portal j/vorkflow. 

Retournez dans le site, creez un dossier et verifiez que vous pouvez bien lui 
appliquer la transition restrict et que son comportement est conforme aux 
attentes. Felicitations ! II ne reste plus qua nous attaquer au workflow du 
contenu... 

Une moderation a deux etages 

Qui dit workflow dit moderation ! En guise d'exercice, nous nous proposons 
de creer deux niveaux de moderation pour le workflow du contenu. 

Par defaut, sous Plone, un contenu est publie a partir du moment oil il est 
valide par le relecteur (role reviewer). Nous allons ajouter un etat interme- 
diaire entre la relecture et la publication, que nous appellerons « en attente 
de validation », ou, pour se conformer a l'utilisation de 1' anglais dans la pro- 
grammation, l'etat validation_pending. Un contenu passe dans cet etat apres 
avoir ete valide par le relecteur. II ne sera effectivement publie qu'apres vali- 
dation par un membre dote du role manager sur ce contenu. Voici comment 
nous y prendre pour modifier le pi one_workf 1 ow. . . 

II convient de creer un etat validation_pending et la transition associee. En 
tout premier lieu, creez le nouvel etat en allant dans les pages appropries de 
portal_workflow. Associez-lui une description et un titre, et associez-lui les 
transitions suivantes : 

• publish (bien sur !) ; 

• reject ; 

• retract. 

Dans l'onglet Security, appliquez la matrice suivante : 



Acq. Perm, 
settings 




Anonymous 


Authenticated 


LocalViewer 


Manager 


Member 


Owner 


Reviewer 




Access contents information 








X 




X 


X 




Change portal events 








X 










Modify portal content 








X 










View 








X 




X 


X 



Nous autorisons le Reviewer a consulter le contenu, mais pas a le modifier. 



Creez ensuite une transition appelee review, qui sera appelee par le role 
reviewer en lieu et place de la transition publish. Void les informations a 
saisir : 



Champ 


Valeur 


Id 


revi ew 


Title 


Valider la relecture 


Description 




Destination state 


val i dati on_pendi ng 


Trigger type 


Initiated by user action 


Script (before) 




Script (after) 




Guard Permission(s) 


Review portal content 


Guard Role(s) 




Guard Expression 




Display name 


Valider 


URL 




Category 


workflow 



II nous reste a «brancher» cet etat en lieu et place du publish de l'etat 
pending. La demarche est logique : placez-vous sur la page consacree a l'etat 
pending, et cochez la case review en plus de la case publish. Et pourquoi ne 
pas retirer la case publ i sh ? Tout simplement parce qu'un individu dote a la fois 
des roles Reviewer et Manager pourra, de la sorte, publier directement son con- 
tenu sans passer par la phase de validation. La vie est belle. 

A ce propos, il ne reste plus qua empecher le role Reviewer d'appeler la tran- 
sition publ i sh lui-meme. Placez-vous sur la page consacree a cette transition, 
et au lieu d'un guard sur la permission Review portal content, utilisez un 
guard sur le role Manager. C'est fait ? Felicitations, votre workflow peut alors 
etre teste copieusement... Enfin presque. 

Vbus souvenez-vous de notre workflow consacre aux dossiers ? Nous avons 
meticuleusement retire les cases Anonymous pour permettre a notre systeme 
base sur le Local Viewer de fonctionner. II convient de faire de meme pour le 
workflow des types de contenu. Voici le positionnement de la securite a 
adopter pour les etats qui le necessitent. 



Attention 

Attention, certains champs sont tatillons quant 
au respect de la casse (majuscules/minuscules). 
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D'abord, l'etat published : 



Acq. Perm, 
settings 




Anonymous 


Authenticated 


LocalViewer Manager Member Owner 


Reviewer 


X 


Access contents information 








X 




X 






Change portal events 








X 










Modify portal content 








X 








X 


View 








X 




X 




Ensuite, l'etat vi si bl e : 


Acq. Perm, 
settings 




Anonymous 


Authenticated 


LocalViewer 


Manager 


Member 


Owner 


Reviewer 


X 


Access contents information 








X 




X 






Change portal events 








X 




X 






Modify portal content 








X 




X 




X 


View 








X 




X 





Le cas particulier de la racine du site 

La racine d'un site Plone n'est soumise a aucun 
workflow. C'est tres pratique dans la mesure ou 
cela vous permet d'appliquer des regies de secu- 
rity complexes a la totalite du site, sans devoir 
associer votre objet Plone Site a un workflow 
qui finirait de toutes facons par etre un cas parti- 
culier... 



Et voila ! Tout est pret. . . N'oubliez pas de cliquer sur le bouton Update secu- 
rity settings du workflow pour mettre la securite en ordre, et pensez bien a 
tester copieusement votre workflow, dans tous les sens, pour verifier que vous 
n'avez rien oublie ! 



II manque enfin la petite touche finale... Avez-vous remarque qu'en tant 
que moderateur vous disposez d'une boite qui vous indique les taches en 
attente ? C'est toujours le cas pour l'etat pending, mais il manque un moyen 
d'indiquer au Manager qu'il a des documents a valider. Placez-vous dans la 
zone Worklists du plone_workflow. C'est ici quest etablie la liste des taches, de 
maniere dynamique. Autrement dit, il nous suffit de declarer une nouvelle 
liste de taches pour que celle-ci soit automatiquement affichee dans la boite 
existant pour le manager. 

Creez une worklist appelee validation_queue. Saisissez les informations 
suivantes : 



Champ 


Valeur 


Id 


manage r_queue 


Description 


Manager tasks 


Cataloged variable matches (formatted) 
review_state= 


val i dati on_pendi ng 


Display name 


Pending (%(count)d) 


URL 


%(portal_url)s/ 

search? revi ew_state=val i dati on_pendi ng 
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Category 


global 


Guard Permission(s) 




Guard Role(s) 


Manager 


Guard Expression 





Vbus pourrez verifier par vous-meme que les taches en attente sont mainte- 
nant indiquees automatiquement au Manager. 



Encore plus d'automatisation ! 

Nous voila heureux de disposer d'un workflow fort pratique pour les dossiers 
et le contenu. Mais nous pouvons aller plus loin... Par exemple, faire en 
sorte d'envoyer un courrier electronique au createur d'un document a chaque 
fois que son etat est modifie. Cela n'est pas tres complique, voici la marche a 
suivre . . . 

Envoi d'un message electronique a I'auteur du document 

Placez-vous dans la zone script du plone_workflow. La page est vide. Nous 
allons creer un script Python capable d'identifier le proprietaire d'un docu- 
ment, d'aller glaner son adresse electronique (si elle est valide), et de lui 
envoyer un message pour lui indiquer que l'etat du document a ete change. 

Creez un script Python appele send_author_email, prenant un parametre 
state_info et contenant le code suivant : 

transitioned = state_info. transition, id 

user = container.portal_membership.getAutrienticatedMember() . 

getUserNameO 

owner = container. portal_membership.getMemberById( 

state_info. object. Creator) 

if owner: 

owner_name = owner. getUserNameO 

owner_email = owner. email 
else: 

owner_name = "(Utilisateur inconnu)" 

owner_email = None 
url = state_info. object. absolute_url () 
title = state_info. object. Title() 



< Nous initialisons deja moult variables en utili- 
sant I'API de Plone. L'objet state„i nfo con- 
tient un objet particulier et est transmis par le 
workflow lors de I'appel du script (nous verrons 
precisement comment un peu plus loin) : 

< II faut prendre en compte le fait que I'owner (ou 
createur) d'un document n'existe plus dans le 
portail. II convient done de se proteger du cas ou 
sa valeur serait None. 
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Nous n'envoyons le message que si I'adresse du 
createur est valide. Cela paraTt logique, mais un 
test de plus dans le code vaut mieux qu'un 
bogue de plus dans le site ! :-) 
Nous utilisons les services du composant 
Mai 1 Host pour envoyer le message, sous forme 
d'une chaine de caracteres relativement brute et 
rudimentaire (le lecteur assidu, curieux, volon- 
taire et courageux pourra implementer un for- 
mulaire de messagerie plus sympathique en 
ZPT). 



if owner_email : 

contai ner . Mai 1 Host . send( 
"""From: Portal Manager <manager@monp~lone.org> 
To: %s <%s> 

Subject: L'etat de votre document %s a change 
Bonjour, 

Nous avons le plaisir de vous informer que l'etat de votre document 
%s situe a I'adresse %s a ete change par 1 'utilisateur %s. 
Cordial ement, 
-- Le webmaster 
""" % (ownerjame, owner_email, title, title, url, user)) 

Jusque la, tout va bien. II ne nous reste plus a indiquer a notre workflow qu'il 
doit executer ce script a chaque passage d'une transition a une autre. 

Pour ce faire, placez-vous sur chacune des transitions du workflow, et selec- 
tionnez le script send_author_email pour l'option Script (after). Testez 
votre workflow : si votre serveur SMTP est valide et que les adresses electro- 
niques de vos utilisateurs sont renseignees correctement, vous devriez alors 
avoir la joie d'envoyer un courrier a l'auteur d'un contenu chaque fois que 
vous changez l'etat de ce dernier ! 



En resume... 

Le workflow est un outil particulierement puissant s'il est bien utilise et mai- 
trise. Les possibilites sont infinies et les scripts de transitions vous permet- 
tent d'obtenir des facultes d'automatisation tres faciles a realiser avec 
Plone - alors qu'elles seraient cauchemardesques avec un autre systeme. 

Libre au lecteur curieux d'aller plus loin dans l'exploration du workflow... 
nul doute que cet outil repondra avec bonheur aux plus exigeants ! 
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Types de contenu 




Type de contenu | Archetypes | ZCIasses 
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► Gestion des types de contenu 

Duplication d'un type de 
contenu 

► Creation d'un produit Python 

► Utilisation d'Archetypes 

MOTS-CLES 

► Type de contenu 

► Archetypes 

► ZCIasses 



po.rtal_factdry 



0 \ tt» 



Creation de types de contenus 













Dans les chapitres precedents, nous avons etudie comment adapter Plone graphi- 
quement et au travers de mecanismes de gestion de publication tel que les work- 
flows. Mais la puissance de Plone ne s'arrete pas la : il est en effet possible de creer 
de nouveaux types de contenu en definissant les donnees qui seront portees ainsi 
que le comportement de ce contenu. C'est la I'objet de ce chapitre. 



Gestion des types de contenu 



B.A.-BA Qu'est-ce qu'un type de contenu 

C'est le support principal de I'information, sous 
Plone. Un type de contenu est une classe structu- 
re, possedant des proprietes et des methodes, 
integree a un portail Plone. Un type de contenu 
derive de certaines classes de base ; ainsi, il pre- 
sente un ensemble de methodes et de proprietes 
standards permettant une parfaite integration a 
Plone. Par exemple, certaines methodes permet- 
tent d'interfacer le type de contenu au catalogue, 
d'autres methodes permettent de definir les 
onglets qui apparaissent dans I'interface d'edition. 
Nous verrons qu'en plus des methodes et des pro- 
prietes, les types de contenus possedent des vues 
et des actions. 



L'outil portal_types 

Sous Plone, les types de contenu sont geres a travers l'outil porta~l_types. Si, 
dans I'interface d'administration de Zope, vous cliquez sur ce composant, vous y 
verrez la liste des types de contenu disponibles pour le portail. 



1 Controls the available Content Types i 


your portal - Mozilla Firebird 








File Edit View Go Bookmarks 


Tools 


Help 












JilH iq v to | q-^ 




4 


► 1 3^ # 


Q Zope on http://localr.ost :8080 




[_j Controls the available Content Type... | 










| Contents J Wiei 


• T 


Properties J Security J Undo J Ownership 


J Find | Actions J Overv 




Version Control ] 


* Plone Types Tool at /Plone/portal tvoes 






Help! 








| DTML Method 




Add | 














r C Discussion Item 






2004-02-04 IS 


06 


V C Document 






2004-02-04 18 


06 


r C Event 






2004-02-04 18 


06 


J~~ C Favorite 






2004-02-04 18 


06 


T C File 






2004-02-04 18 


06 


r C Folder 






2004-02-04 18 


06 


r d Image 






2004-02-04 18 


06 


r C Large Plone Folder 






2004-02-04 18 


06 


r C Link 






2004-02-04 18 


06 


F C News Item 






2004-02-04 18 


06 


r C Plone Site 






2004-02-04 18 


06 


r C PloneArticle 






2004-02-04 18 


12 


l~~ C TernpFolder 






2004-02-04 18 


06 


r C Topic 






2004-02-04 18 


□ 6 




Rename | Cut | Copy 


Delete Import/Export Select All 





















Figure 7-1 Un premier apercu de l'outil portal_types 



Certains de ces types de contenu vous sont deja familiers, d'autres peuvent vous 
paraitre etranges (Discussion Item ou Topic, par exemple). Cliquez sur le type 
Document pour consulter le detail de ses proprietes dans la page qui s'affiche 
(figure 7-2). 

Vous pouvez, grace a cette page, modifier certaines des informations liees a ce 
type de contenu, comme son titre (le nom qui apparait dans la boite deroulante 
d'ajout de contenu du site), sa description, etc. Void ce que vous pouvez 
modifier : 

• Title - II s'agit bien entendu du titre du type de contenu. 

• Description - Description du type de contenu, apparaissant dans certaines 
pages de Plone. 

• Icon - Nom de l'icone (devant etre dans la skin) utilisee pour representer un 
objet de ce type. II s'agit de la modification la plus simple et la plus parlante 
a effectuer sur un type de contenu ! 
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J Actions 1 
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P T Security 


1 Version Control 1 




C Factory-based Type Information at /Plone/portal types/Document 


Help! 


Properties allow you to assign simple values to Z 


□pe objects. To change property values, edit the 


values and click "Save 


Changes". 












Name 


Value 






Type 




Title 








strina 




Description 






text that can be 


text 


















They may also con 


tain HTML, or 


















Icon 


document_icon.gif 






string 




Product meta type 


Document 






string 




Product name 


CMFDefault 






string 




Product factory method 


add Document 






string 




Initial view name 


document_view 






string 




Implicitly addable? 








boolean 




Filter content types? 


W 






boolean 




Allowed content types 


Discussion Item 






multiple selection 






Document 












Event 












Favorite 












File 












Folder 












Image 










Allow Discussion? 


r 






boolean 






Save Changes | 











Figure 7-2 Le type de contenu Document 



Product meta type, Product name et Factory method - Nous decrirons ces 
informations ulterieurement. 

Initial view name - Nom de la page (depuis la skin) qui apparait lorsqu'un 
nouvel element de ce type est cree. Ici, il s'agit de document_view, mais nous 
aurions pu mettre document_edit pour indiquer que lors de la creation d'un 
objet de ce type, on se place directement sur l'onglet Edit. 
Implicitly addable - Si cette case est cochee, alors un membre peut lui-meme 
ajouter un objet de ce type. Si elle n'est pas cochee, il n'est possible de creer 
des objets de ce type que par programmation. Retirer la coche de cette case 
est sans conteste le moyen le plus simple et le plus rapide pour inhiber un 
type de contenu. 

Filter content types et Allowed content types : pour les objets conteneurs 
(Folder, par exemple), ces deux options permettent de specifier les types de 
contenu autorises en tant que contenu. Ces options sont tres rarement utili- 
sees. 

Allow discussion - Si cette case est cochee et si la discussion est autorisee sur 
le site, alors le type de contenu pourra etre commente. Dans le cas contraire, 
il ne pourra pas l'etre. 



File Edit View Go Bookmarks Tools 



huh & ss q © I <*• 



-inlxl 



U Zope on http://localhost:8080 



Controls the available Content Type... 

T — . 



X 



■ Factory-based Type Information at /Plone/portal types/ Document 



I - Name 
Id 



[View 
[view 



Action (stri ng: ${□ bject_url}/dQcum e nt_view 
Condition | 
Permission I View 



Category [object 
Visible? [7 



r Name [Edit 
Id [edit 



Action |string:J{object_url}/document_edit_torm 
Condition f_ 



Permission | Modify portal content 
Category [object 
Visible? 17 



[Propertie 



[metadata 



Action (string:${object_url}/metadata_edit_form 



Condition f" 

Permission | Modify portal content 



Category [object 
Visible? 17 



Figure 7-3 Page d'edition des actions 

Dans la suite de ce chapitre, nous allons decouvrir comment creer de 
pieces de nouveaux types de contenu. 



toutes 



Comment creer un nouveau type de contenu ? 

II y a plusieurs methodes pour creer de nouveaux types de contenu. Nous allons 
passer rapidement en revue trois d'entre elles, pour nous attarder ensuite sur la 
quatrieme, nettement plus interessante, puissante et efficace que les trois prece- 
dentes. 

Ces methodes sont : 

• duplication a partir dun type existant ; 

• creation a partir dune ZClass ; 

• developpement d un produit Python complet ; 

• utilisation d'Archetypes. 
Les void done en detail. . . 
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Creer a partir d'un type existant 

Un type de contenu est un objet qui se base sur un produit de contenu CMF. II 
est done possible de definir plusieurs types differents, a partir d'un meme pro- 
duit. Ainsi, vous pouvez creer un type de contenu personnalise a partir d'un type 
existant. C'est la solution de personnalisation la plus simple, mais e'est egale- 
ment la plus limitee. Faites le test avec le type Document par exemple. 
L'operation peut etre tres simple et prendre deux minutes. Via l'interface 
d'administration de Zope, faites une nouvelle copie du type Document (avec les 
boutons Copy et Paste), puis renommez-le en Article, par exemple. Ensuite, 
dans l'interface d'edition du type, modifiez son titre, sa description et son meta- 
type. Le resultat est immediat, comme vous pouvez vous en rendre compte en 
accedant au site en tant que membre via l'interface publique. Vous pouvez, en 
utilisant la liste deroulante d'ajout de contenu, creer un nouvel objet de type 
Article : celui-ci aura les memes proprietes que le type Document mais pourra 
par exemple etre lie a un workflow different, ou etre muni d'actions differentes. 



Pour aller au bout de la personnalisation a partir 
d'un type existant, il faut egalement changer les 
objets de presentation correspondant aux actions, 
notamment celles de visualisation et d'edition des 
contenus Arti cl e. II est logique que chaque type 
ait sa propre presentation. 



Creer a partir d'une extension ZCIass 

Zope permet d'etendre les classes d'objets standards, telles que Image ou Folder, 
en creant via le Web des composants nommes ZCIass, avec la possibilite de leur 
definir des proprietes, des methodes d'edition, des vues, et de les indexer avec le 
ZCatalog. Grace a cette technique, vous pouvez done definir une nouvelle classe 
d'objets heritant de classes de CMF, principalement la classe de base 
Portal Content. Cette solution est ideale pour ceux qui ne veulent pas trop pro- 
grammer mais creer de nouveaux types de contenu relativement complets. 
Nous allons utiliser le cas, par exemple, d'un systeme d'offres d'emploi internes, 
et creer un nouveau type de contenu Dob. 



B.A.-BA Les ZCIass de Zope 
Qu'est-ce qu'une ZCIass ? 

Une ZCIass ou Z Classe est un produit Zope, qu'il est possible de 
creer, programmer, maintenir et distribuer entierement via le Web. II 
est possible de creer une ZCIass a partir de rien, ou de batir une 
classe derivee d'une ZCIass existante ou d'une classe Zope. 

Pourquoi utiliser une ZCIass ? 

Les ZCIass ont leurs defenseurs et leurs detracteurs. II faut envisa- 
ger la ZCIass comme un outil permettant de creer facilement et 
rapidement ses propres objets, en gardant a I'esprit que les ZC1 ass 
ont aussi leurs limites. Nous avons, au chapitre precedent, oppose 
les Python Scripts aux External Methods. Les ZC1 ass peuvent etre vues 
d'une certaine maniere comme la version objet des Python Scripts. 
Nous verrons au chapitre suivant qu'il est possible de creer des pro- 
duits qui, eux, ne souffrent d'aucune limitation. 



Une ZCIass permet done de definir de nouveaux types d'objets 
Zope. 

Les ZCIass presentent toutefois les inconvenients suivants : 

• Pour les creer ou les maintenir, il faut disposer des droits suffi- 
sants dans le dossier Control Panel de Zope : ceci peut dissua- 
der les hebergeurs bases sur Zope d'ouvrir une partie de leur ser- 
veur. 

• Leur fonctionnement est soumis a certaines limites : le program- 
mer n'a pas acces a la structure interne de Zope et doit cons- 
truire sa ZC1 ass a partir d'un moule fige. Cette contrainte empe- 
che la creation d'applications vraiment complexes avec des 
ZCIass; nous verrons que les produits Python, en revanche, 
n'ont pas de telles limites. 
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L'utilisation de ZC1 ass se fait de plus en plus rare sous Zope. En effet, les limita- 
tions sont telles queries ne valent plus la peine de les subir. . . Et il est desormais 
possible, avec juste un peu plus de programmation, de creer des types de con- 
tenu complets et parfaitement fonctionnels. C'est ce que nous allons voir a 
l'etape suivante. 

Creer a partir d'une extension Produit Python 
Developper votre produit d'extension Python 

Si vous avez une classe d'objets relativement complexe a mettre en oeuvre pour 
votre site Plone, il est recommande de creer un produit. Imaginons par exemple 
le cas d'un annuaire interne oil chaque fiche serait un contenu dans le site. Le 
produit doit definir une classe permettant aux employes de la societe d'ajouter 
des entrees a l'annuaire. 

Demarrage 

Le developpement d'un produit Python se fait essentiellement sur le systeme de 
fichiers, et non pas a travers l'interface d'administration de Zope. Creez un 
repertoire nomme Annuaire dans le repertoire $ZOPE/~lib/python/Products. 
Creez dans ce nouveau repertoire, a partir de votre editeur de texte prefere, les 
fichiers suivants : FicheAnnuai re.py et FicheAnnuai rePermissions.py. lis vous 
serviront a creer respectivement le module de la classe d'objets Plone nommee 
FicheAnnuai re et le module de definition des permissions de cette classe. 

Le module de definition des permissions 

C'est le module le plus simple a mettre en place, et le plus court (cinq lignes de 
code ici). Vous creez respectivement la permission d'ajout des objets et celle de 
leur modification, puis vous affectez a ces deux permissions des roles par defaut 
(Manager et Owner). Votre module contient le code suivant : 

from Products. CMFCore.CMFCorePermissions import setDefaultRoles 

# Definissons les permissions 
AddFiche = 'Add Fiches' 
ChangeFiche = 'Change Fiches' 

# Affectons les roles par defaut a ces permissions 
setDefaultRoles(AddFiche, ('Manager', 'Owner',)) 

| setDefaultRoles(ChangeFiche, ('Manager', 'Owner',)) 

Le module de definition de la classe 

Dans le fichier FicheAnnuai re.py, Vous devez importer un ensemble de 
modules qui apportent les fonctionnalites utiles a la mise en ceuvre de votre 
classe Zope : 

from Global s import Initialized ass 

from AccessControl import ClassSecuritylnfo 

import string 



Les proprietes associees a la classe Entreprise 

Typiquement, vous choisirez la liste de proprietes suivante : 



Propriete 


Nom 


Type 


Raison sociale 


raison_sociale 


Chaine de caracteres 


Nom du contact 


Contact 


Chaine de caracteres 


Adresse 


Adresse 


Chaine de caracteres 


Code postal 


code_postal 


Chaine de caracteres 


Ville 


Ville 


Chaine de caracteres 


Telephone 


telephone 


Chame de caracteres 


Fax 


Fax 


Chaine de caracteres 


E-mail 


Email 


Chaine de caracteres 


Site Web 


site url 


Chatne de caracteres 



Pourquoi importer ces classes ? Zope fournit une API avec un certain nombre 
de classes fondamentales. Pour qu'une classe d'objets Zope soit valide et puisse 
utiliser toute la puissance de l'environnement, il faut en quelque sorte signer un 
contrat avec ces classes au debut du module. L'importation de chacune de ces 
classes represente un contrat avec le service ou le protocole concerne. Ainsi, sur 
la base de ces contrats, notre classe aura acces aux fonctionnalites de bas niveau 
fournies par Zope. Par exemple, la classe AccessControl .□assSecuritylnfo 
permet de gerer la securite des objets au sein de votre produit. 
Plone est un framework specialise au-dessus de Zope. II definit done egalement 
des classes de base differentes de celles de Zope. Vous devez permettre l'acces 
aux fonctionnalites et services fournis par le framework en ajoutant les importa- 
tions suivantes : 

from Products. CMFDefault.DublinCore import DefaultDublinCorelmpl 
from Products. CMFCore. Portal Content import PortalContent 
from Products. CMFCore import CMFCorePermissions 

Notez le fait qu'on importe le module CMFCorePermissions du produit de base 
CMFCore. Mais ce n'est pas tout. Vous avez commence le travail en definissant 
des permissions specifiques pour votre produit, dans le module 
Entrepn'sePermissions. C'est le moment d'importer ce module, puisque vous 
en aurez besoin pour mettre en oeuvre la securite de votre nouvelle classe 
d'objets. 

import EntreprisePermissions 



Le Factory Type Information 

II s'agit de la definition dune structure de donnees Python de type tuple 
nommee factory_typeJnformation. Cette definition est utilisee pour cons- 
truire le type d'objet au moment du chargement dans la base de donnees de 
Zope, au sein du composant outil portal _types. 

Details du Factory Type Information Definition du type Entreprise (pour I'outil portal_types) 

• id- L'identifiant unique de I'objet « type de 
contenu » (comme pour tout objet Zope) ; 

• meta_type - Le nom du produit tel qu'indique 
a I'utilisateur dans Control_Panel/ 
Products ; 

• descri ption - Comme son nom I'indique, la 
description de I'objet telle qu'indiquee a 
I'utilisateur ; 

• content_icon - L'icone correspondant au 
type de contenu (optionnel) ; 

• product - Le produit auquel appartient notre 
type (correspond au nom du repertoire) ; 

• factory- La methode Python qui va creer 
I'instance de notre objet dans le site CMF ; 

• immediate_view- La page template qui va 
etre appelee apres la creation de I'objet ; 

• actions - La structure de type tuple definis- 
sant les actions. 



Resume 

Vous devez definir au minimum les trois actions presentees dans le tableau suivant : 



Id 


Norn/Label 


Template (skin) 


Permission 


view 


Voir 


entreprise_view 


View 


edit 


Editer 


entreprise_edit_form 


ChangeEntreprises 


metadata 


Meta-donnees 


metadata_edit_form 


ChangeEntreprises 



La methode d'ajout (factory) 

Apres ces definitions, nous passons a la methode de creation d'un objet 
Entreprise au sein de la base de donnees objet de Zope, ce sans quoi nous ne 



factory_type_i information = ({ 
'id' : 'Entreprise', 
'content_icon' : '', 
'meta_type' : 'Entreprise', 

'description' : "Entree d'une entreprise dans l'annuaire" 
'product' : 'CMFAnnuai re' , 
'factory' : 'addEntreprise' , 
'immediate_view' : ' entrepri se_edi t_form ' , 
'actions' : ({ 

'id' : 'view' , 

'name' : 'Voir', 

'action' : 'entreprise_view' , 

'permissions' : (CMFCorePermi ssions .View, ) 



}, 
{ 'id' 
'name' 
'action' 
'permissions' 

}, 

{ 'id' 
'name' 
'action' 
'permissions' 

}, 



'edit', 
'Editer' , 

'entreprise_edit_form' , 

(Entrepri sePermi ssi ons . ChangeEnt repri ses , ) 

'metadata' , 
'Meta-donnees' , 
'metadata_edit_form' , 

(Entrepri sePermi ssi ons . ChangeEnt repri ses , ) 



},) 
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pourrions pas gerer nos objets de contenu de maniere persistante (un des avan- 
tages de la ZODB ou Z Object Database). 

' def addEntreprise(self , id, title=", REQUEST=None) : 
Methode « factory » de l'objet Entrepri se""" 

obj = Entrepn'se(id) 
obj .id = id 

obj. title = title 

self ._setObject(id, obj) 

if REQUEST is not None : 

REQUEST . RESPONSE . redi rect ( ' manage_mai n ' ) 

A partir des attributs id et title et de l'objet de la requete HTTP, cette 
methode cree une instance de la classe Entrepri se et l'ajoute au sein de la base 
de donnees de Zope (la ZODB) en appelant la methode interne _setObject. 
Maintenant que la methode d'instanciation des objets est prete, nous pouvons 
nous atteler a definir la classe elle-meme. 

La classe Entreprise 

class Entreprise(PortalContent, DefaultDublinCorelmpl) : 

"""Une entreprise""" 
meta_type = "Entreprise" 
security = ClassSecuritylnfoO 

security .dec! areObject Protected (CMFCorePermi ssions . View) 



def init_(self, id, title="): 



Defaul tDubl i nCorelmpl . i ni t(sel f) 

self .id=id 

self .title=ti tie 

self . raison_soci ale = 11 

self .contact = ' ' 

self .adresse = ' ' 

self . code_postal = 11 

self .ville = ' ' 

self .telephone = ' ' 

self .fax = ' ' 

self .email = ' ' 

self . site url = ' ' 



Creation de l'objet de type Entreprise. 



Affectation des proprietes idoines. 



Ajout de l'objet a I'arborescence Zope. 



Redirection vers la page d'administration. 



Notre classe herite des classes Po rtal Content 
et Defaul tDubl i nCorelmpl . 



Chatne de documentation. 



Definition du meta-type. 



Creation d'un objet charge de la gestion de la 
securite des methodes et attributs de la classe : 
il s'agit d'un mecanisme offert par Zope permet- 
tant aux Produits Python de disposer de metho- 
des privees, protegees ou publiques, et regies 
par les permissions de Zope. 

La methode i ni t est le constructeur de la 

classe : cette methode est automatiquement 
appelee par Python au moment de I'instancia- 
tion de la classe. 



< Appel de la methode d'initialisation de la classe 
parente. 

< Ces lignes de code permettent de renseigner les 
champs de notre objet avec des valeurs par 
defaut. 
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Grace a l'heritage multiple permis par Python, votre classe possede deux ance- 
tres. En fonction de vos besoins, vous pouvez lui faire heriter d'autres classes 
telles que CMFCore. Portal Folder ou OFS. Image. File. 
L'attribut meta_type caracterise les objets crees a partir de cette classe. 

Vient ensuite la methode init , chargee d'initialiser l'instance de la classe. 

Notez l'instruction secu ri ty . decl areOb j ectProtected (CMFCorePe rmi ssi ons . Vi ew) 
ou vous vous servez de l'instance de la classe ClassSecuritylnfo pour proteger 
l'acces a cette methode par la permission Vi ew. 

Dans cette methode init , vous faites appel a la methode d'initialisation de 

DefaultDublinCorelmpl, ce qui initialise toutes les metadonnees de l'objet, telles 



RAPPELS 

La classe DefaultDublinCorelmpl vous permet d'avoir acces aux 
fonctionnalites de metadonnees selon le standard Dublin Core, telles 
qu'implementees dans le CMF. 

L'heritage de la classe Portal Content, comme nous I'avons deja 
vu, est necessaire pour que l'objet soit utilisable en tant que contenu 
au sein du site CMF. 



Interfaces des metadonnees 
(classe DefaultDublinCorelmpl) 



Interfaces du contenu (classe PortalContent) 



Interface 


Description 


Title 


Titre du contenu 


Creator 


Createur 


Subject 


Liste de mots-des representant le sujet 
du contenu 


Descri ption 


Description 


Contri butors 


Liste des contributeurs 


CreationDate 


Date de creation 


Effecti veDate 


Date de publication effective 


Expi rationDate 


Date d'expiration du contenu 


ModificationDate 


Date de modification 


Type 


Type du contenu (par exemple, 
Document, Lien, ou Image) 


Format 


Format (par exemple texte, texte 
structure ou texte HTML) 


Language 


Langue 


Rights 


Droits (copyright) 



Interface 


Description 


i ndexObject, 
rei ndexObject 


Permet d'indexer le contenu apres 
sa creation ou sa modification 
(rei ndexObject). 


uni ndexObject 


Permet de supprimer le contenu de 
la base d'indexation, avant sa 
suppression physique. 


manage_afterAdd 


Interface des actions a effectuer sur 
l'objet apres son ajout dans la 

70I~)R Fn nonor^ii \/nnc n 3\/c7 n^c J> 
L\JUu. nil yCllclalf VUUd II avc£. fJab a 

le surcharger dans votre produit. 


manage_beforeDelete 


Interface des actions a effectuer sur 
l'objet avant sa suppression de la 
ZODB. En general, vous n'avez pas a 
le surcharger dans votre produit. 


Li stFi 1 teredActi onsFor 


Retourne toutes les actions 
disponibles de maniere contextuelle, 
sous la forme d'un dictionnaire 
contenant les actions liees a 
I'utilisateur telles que Undo, les 
actions liees a l'objet, et les actions 
globales telles que 
folder_contents. 


SearchableText 


Permet la recherche textuelle du 
contenu en retournant la liste des 
proprietes que le ZCatalog doit 
prendre en compte pour les index de 
type « texte ». 

Vous pouvez avoir a le surcharger 
en fonction des specificites de votre 
classe d'objets. 
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que la description, la date de creation et l'auteur. Vous initialisez ensuite les pro- 
prieties qui constituent le schema de votre classe. 

Ou en sommes-nous ? Chaque instance de la classe peut s'initialiser avec tous 
ses attributs et herite du comportement defini par les classes Portal Content et 
DefaultDublinCorelmpl, notamment l'indexation et la reindexation automa- 
tique. Vous allez maintenant permettre son edition, c'est-a-dire la modification 
de ses proprietes. Cela se fait grace a la methode suivante, nommee edi t et pro- 
tegee par la permission ChangeEntreprises. 

secu ri ty . dec! areProtected (Ent repri sePermi ssi ons . ChangeEnt repri ses , ' edi t ' ) 
def edit(self, raison_sociale=None, contact=None, adresse=None, 

code_postal=None, ville=None, telephone=None, fax=None, 

email=None, site_url=None) : 

"""Edition de 1 'objet 

self . raison_soci ale = raison_sociale 

self. contact = contact 

self.adresse = adresse 

self . code_postal = code_postal 

self, vi lie = ville 

self .telephone = telephone 

self. fax = fax 

self, email = email 

self . site_url = site_url 

self . portal_catal og. rei ndexObject() 

La methode decl areProtected permet de declarer une methode de notre classe 
comme etant protegee par une permission de Zope. Ici, la methode edit est 
protegee par la permission ChangeEnterprises : il n'est pas possible a un utilisa- 
teur de se servir d'edit s'il n'en a pas la permission. 

La methode reindexObject permet de mettre a jour l'objet dans le catalogue du 
portail. Sans cet appel a reindexObject, le catalogue du portail indexerait tou- 
jours l'ancienne version de l'objet, sans tenir compte des modifications appor- 
tees a ses attributs, ce qui est plutot genant pour faire des recherches sur des 
objets a jour ! 

La derniere ligne de code du module sert a initialiser la classe Entreprise. 

# initalisation 

Ini ti al i zeCl ass (Ent repri se) 

La skin du produit 

Vous pouvez maintenant creer au sein du repertoire CMFAnnuai re, un repertoire 
nomme Skins dans lequel vous creez un sous-repertoire nomme Entreprise. 

Le formulaire d'edition 

Dans le sous-repertoire /CMFAnnuai re/Ski ns/Entreprise, creez un fichier texte 
nomme Entreprise_edit_form.pt (Y extension etant necessaire pour une Page 
Template) et ajoutez-y le code HTML suivant afin de fournir le formulaire 
d'edition des nouveaux objets : 



S 




Ensuite, on reindexe l'objet (pour le 
i portal_catalog). 
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<html metal :use-macro="here/main_template/macros/master"> 
<body> 

<div metal :fi~ll-s~lot="main"> 

<hl>Edition des informations de 1 'entreprise</hl> 
<form class="group" 

name="edit_form" 
action="entreprise_edi t" 
method="post"> 
<div class="row" 

tal :define="Title request/title | here/Title; "> 
<span class="label">Titre </span> 
<span class="field"> 
<input type="text" 

name="field_title" 

size="40" 

value="#" 

tal :attributes="value Title" /> 

</span> 
</di v> 

<div class="row" 

tal :define="raison_sociale request/raison_sociale | 
here/raison_sociale" > 
<span class="label">Raison social e</span> 
<span class="field"> 
<input type="text" 

name="f i el d_rai son_soci al e" 

size="40" 

value="#" 

tal :attributes="value raison_sociale" /> 

</span> 
</di v> 

<div class="row" > 

<span class="label"> Categorie(s) </span> 
<span class="field"> 

<select name="field_categories:list" multiple 
tal :define="categories here/Subject; 
allowedSubjects 
python : he re . po rtal _metadata . 
*»li stAllowedSubjects(here)"> 
<option value="cat" 

tal : repeat="cat allowedSubjects" 
tal : attri butes="val ue cat ; 

selected python: cat in categories 
and 1 or 0" 
tal :content="cat">Une categorie</option> 

</select> 
</span> 
</di v> 

<div class="row" 

tal :define="contact request/contact | here/contact" > 
<span class="label">Nom du contact</span> 
<span class="field"> 



s 

<input type="text" u> 
name="field_contact" S; 
size="40" i 
value="#" ^ 
tal :attributes="value contact" /> 

</span> 
</div> 

<div class="row" 

tal :define="adresse request/adresse | here/adresse" > 
<span cl ass="l abel ">Adresse</span> 
<span class="field"> 
<input type="text" 

name="field_adresse" 

size="50" 

val ue="#" 

tal :attributes="value adresse" /> 

</span> 
</div> 

<div class="row" 

tal :define="code_postal request/code_postal | 
here/code_postal " > 
<span class="label ">Code Postal </span> 
<span class="field"> 
<input type="text" 

name="field_code_postal " 

size="25" 

val ue="#" 

tal :attr~ibutes="value code_postal" /> 

</span> 
</div> 

<div class="row" 

tal :define="ville request/ville | here/ville" > 
<span class="label ">Ville</span> 
<span class="field"> 
<input type="text" 

name="f i el d_vi 1 1 e" 

size="25" 

val ue="#" 

tal :attributes="value ville" /> 

</span> 
</div> 

<div class="row" 

tal :define="telephone request/telephone | here/telephone" > 
<span cl ass="l abel ">Tel ephone</span> 
<span class="field"> 
<input type="text" 

name="f i el d_tel ephone" 

size="25" 

val ue="#" 

tal :attnbutes=" value telephone" /> 

</span> 
</div> 
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<div class="row" tal :define="fax request/fax | here/fax" > 
<span class="label">Fax</span> 
<span class="field"> 
<input type="text" 

name="field_fax" 

size="25" 

value="#" 

tal :attributes="value fax" /> 

</span> 
</di v> 

<div class="row" 

tal :define="email request/email | here/email" > 
<span cl ass="l abel ">E-mail </span> 
<span class="field"> 
<input type="text" 

name="f i el d_emai 1" 

size="25" 

value="#" 

tal :attributes="va~lue email" /> 

</span> 
</di v> 

<div class="row" 

tal :define="site_url request/site_url | here/site_url " > 
<span class="label">Site Web (URL)</span> 
<span class="field"> 
<input type="text" 

name="field_site_url " 

size="25" 

value="#" 

tal :attributes="value site_url" /> 

</span> 
</di v> 

<div class="row"> 

<span class="label"x/span> 
<span class="field"> 

<input class="context" type="submit" 
name="submit" value=" OK " /> 

</span> 
</di v> 



</form> 

</di v> 

</body> 

</html> 
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Le script d'edition 

Creez egalement un fichier nomme Entrepri se_edi t . py et ajoutez-y le code du 
script d'action du formulaire d'edition. 

## Script (Python) "entrepri se_edit" 
## parameters^ 
## title= 

REQUEST=context . REQUEST 

context . edi tMetadata(ti tl e=REQUEST [ ' f i el d_ti tl e ' ] 

, subject=REQUEST['field_categories']) 

context . edi t (rai son_soci al e=REQUEST [ ' f i el d_rai son_soi ci al e ' ] 

, contact=REQUEST [ ' f i el d_contact ' ] 

, adresse=REQUEST['field_adresse'] 

, code_postal=REQUEST['field_code_postal '] 

, vine=REQUEST['field_ville'] 

, tel ephone=REQUEST [ ' f i el d^tel ephone ' ] 

, fax=REQUEST['field_fax'] 

, email=REQUEST['field_email' ] 

, site_url=REQUEST['field_site_url' ]) 
REQUEST. set('portal_status_message' , 'Entreprise+changee. ') 
qst= ' portal_status_message=Entrepri se+changee . ' 
target_action = context. getTypelnfoO .getActionById( 'view' ) 
context. REQUEST. RESPONSE. redirect ( '%s/%s?%s' % ( 
context . absol ute_u rl () 

, target_action 
, qst 

) ) 



< Appel de la methode d'edition des metadon- 
nees. 



Appel de la methode edit, que nous avons creee 
dans notre classe. 



Le template de visualisation 

Enfin, vous devez creer un fichier nomme Entreprise_view.pt pour la template 
de visualisation du contenu. Ajoutez-y le code HTML suivant : 

<html metal :use-macro="here/main_template/macros/master"> 
<body> 

<div metal :fill-slot="main" > 

<hl tal :content="here/Title >Titre</hl> 
<div class="row"> 

<span class="label ">Raison sociale de 1 'entreprise</span> 
<span class="field" tal :content="here/raison_sociale" > 

Rai son sociale 
</span> 
</div> 

<div class="row"> 

<span cl ass="l abel ">Categori e(s)</ span> 
<span class="field" 

tal :content="python:modules['string'] . 

join(here.Subject() , ' ')">Categorie 

</span> 
</div> 
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<div class="row"> 

<span cl ass="l abel ">Contact</ span> 

<span class="field" tal :content="here/contact" > Contact 
</span> 
</di v> 

<div class="row"> 

<span cl ass="l abel ">Adresse</ span> 

<span class="field" tal :content="here/adresse" > Adresse 
</span> 
</di v> 

<div class="row"> 

<span class="label">Code Postal</span> 
<span class="field" 

tal : content="here/code_postal " > Code postal 

</span> 
</di v> 

<div class="row"> 

<span cl ass="l abel ">Vi 1 1 e</ span> 

<span class="field" tal :content="here/ville" > Ville 
</span> 
</di v> 

<div class="row"> 

<span cl ass="l abel ">Tel ephone</ span> 

<span class="field" tal :content="here/telephone" >Telephone 
</span> 
</di v> 

<div class="row"> 

<span class="label">Fax</span> 

<span class="field" tal :content="here/fax" > Fax</span> 
</di v> 

<div class="row"> 

<span cl ass="l abel ">E-mai 1 </span> 

<span class="field" tal :content="here/email " > Emai l</span> 
</di v> 

<div class="row"> 

<span class="label">Site web</span> 
<span class="field"> 

<a href="" tal :attributes="href here/site_url " 

tal :content="here/site_url" > URL du site </a> 

</span> 
</di v> 

</di v> 

</body> 

</html> 

Le module d'initialisation du produit 

II faut maintenant ajouter au repertoire du produit le fameux module 

init .py afin de permettre qua son demarrage, le serveur Zope puisse 

trouver le produit et le rendre accessible. 



Vous devez importer d'une part le (les) module(s) de votre produit, et d'autre 
part un certain nombre de classes et de modules de CMFCore. Pour ce produit, les 
trois lignes suivantes devraient suffire : 

import Entreprise 

from Products. CMFCore import Di recto ryView, utils 
from Products. CMFCore import utils, CMFCorePermissions 

Ensuite, vous transformez les repertoires contenant les fichiers de skin du pro- 
duit en objets de type File System Di rectory View : 

Di rectoryView. registerDi rectory (' ski ns ' , global s()) 

Di rectoryView. registerDi rectory('ski ns/entreprise' , global s()) 

Enfin, vous definissez la methode initialize au sein de laquelle vous declarez 
le produit de contenu pour Zope, en lui indiquant la classe d'objets, la permis- 
sion d'ajout de contenu, le constructeur et le type associe. C'est egalement la que 
vous choisissez, pour votre nouveau produit, le nom qui apparait dans le menu 
deroulant d'ajout d'objets au sein de l'interface de management de Zope. 

def i initialize (context) : 
utils. ContentInit( 

'Entreprise Content Objects' 

, content_types=(Ent reprise. Entreprise,) 

, permi ssion=CMFCorePermissions.AddPortal Content 

, extra_constructors=(Ent repri se . addEnt repri se , ) 

, f ti =Ent repri se . facto ry_type_i nf ormati on 

) .initialize(context) 

Integrer le nouveau type 

Maintenant que votre produit fournissant la classe d'objets est pret, vous pouvez 
creer une definition de type de contenu qui se base sur ce produit. La procedure 
est la meme que celle du produit ZClass, sauf qu'au moment ou vous arrivez sur 
la fenetre d'ajout du Factory-based Type Information, vous pouvez selectionner 
la classe dans la liste des classes de contenu disponibles. Vous selectionnez alors 
CMFAnnuai re : Entrepri se et vous validez, sans oublier de specifier un identifiant 
tel que Entreprise. L'objet de type se cree et contient les parametres tels que 
vous les avez definis au sein du produit avec le factory_type_inf ormati on. Bien 
sur, vous pouvez ensuite faire des modifications mineures sur certains parame- 
tres, independamment du produit. 

Voila. Tout est en place, ou presque. II ne reste plus qua charger la sous-skin 
permettant l'interaction Web avec le nouveau type de contenu. 

Integrer la sous-skin du nouveau type 

Cette derniere etape consiste a ajouter la sous-skin au sein de l'outil 
portal_skins, et a mettre a jour les chemins de skins au niveau de son interface 
Properties. Comme vous avez un nombre sans cesse croissant de sous-skins, 



RAPPEL 

Un produit de contenu CMF reste un produit Zope. 
Vous pouvez ajouter les instances des classes defi- 
nies dans le produit via la ZMI. Ceci dit, CMF 
apporte une nouvelle interface pour les gestion- 
naires de contenu, et ceux-ci n'ont jamais acces a 
la ZMI. 



QUALITE Bogues 

Pour tester votre produit, vous devez bien sur 
demarrer Zope. Au moment ou Zope interprete le 
code du produit, il se peut qu'il vous affiche des 
messages d'erreur. Soyez done attentif a ce qui 
s'affiche sur la fenetre de demarrage du serveur, 
afin de pouvoir efficacement « chasser les 
bogues » s'il y en a. Si aucun message d'erreur 
n'est affiche, alors le plus dur est fait. 
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l'operation peut etre fastidieuse et source d'erreur. II y a une solution, qui con- 
sists tout simplement a faire executer ce travail de configuration par Python. 
Creez le module suivant au sein du sous-repertoire Extensions de votre reper- 
toire Zope, en le nommant cmf_utils : 

from Products. CMFCore.uti Is import getToolByName 
import string 

def addFSDi rectoryView(self , skin_id, physicalji rectory) : 
ski ns_tool =getTool ByName(sel f , ' portal _ski ns ' ) 
skins_tool .manage_addProduct['CMFCore'] . 

manage_addDi rectoryView(id=skin_id, 
filepath=physical_di rectory) 
selections = skins_tool ._getSelections() 
for id, skinpath in sel ections.i terns () : 
skinpath=skinpath.split(' , ') 
skinpath.insert(2, skin_id) 
selections[id]=string. join(skinpath, ' , ') 
skins_tool ._selections=selections 

Ensuite, au sein de Zope, a la racine de votre instance de CMF, creez une 
methode externe avec les parametres suivants : 

• id : addFSDi rectoryView ; 

• module : cmf_utils ; 

• function : addFSDi rectoryView. 

Creez enfin un script Python, nomme addSkinElement, faisant appel a la 
methode externe que vous venez de creer, en lui passant l'identifiant avec lequel 
la sous-skin doit etre creee, et le chemin du repertoire sur le systeme de fichiers 
(a adapter selon votre cas) : 

context . addFSDi rectoryVi ew(context , ' entrepri se ' , 

'/home/zope/1 i b/python/Products/CMFAnnuai re/ski ns/entrepri se ' ) 
return 'fin' 

Vous lancez l'operation via l'onglet Test du script addSkinElement, et le tour est 
joue. 

Utiliser le nouveau type de contenu 

Parametrer une liste de mots-des pour le champ des categories 

Le dernier parametrage a faire par le gestionnaire ou le concepteur du site con- 
sists a definir une liste de mots-cles pour la valeur du champ Categori es, qui est 
proposee aux membres lorsqu'ils creent du contenu Entrepri se au sein de 
l'annuaire. C'est exactement ce que permet de faire le composant de gestion des 
metadonnees portal _metadata. 

Cliquez sur ce composant, puis sur son onglet Elements, et enfin sur le lien cor- 
respondant a l'element de metadonnees qui vous interesse, afin d'obtenir son 



formulaire de definition. En fait, le formulaire de l'element Subject etant ouvert 
par defaut lorsqu'on accede a l'interface des elements, vous n'avez pas besoin de 
cliquer une deuxieme fois. 

Une premiere section montre une definition commune a tous les types. Le but 
est de faire une definition specifique pour certains types. C'est ce qui a ete fait 
au sein de Plone pour le type Event (du produit CMFCalendar), dont la section 
apparait en deuxieme position. A la suite, vous avez la possibilite d'ajouter votre 
definition pour le type Entreprise. Selectionnez votre type a partir de la liste 
deroulante des types de contenu disponibles sur le site. Vous pouvez maintenant 
faire votre definition dans la section reservee a ce type en vous inspirant de ce 
qui a ete fait pour le type Event : 

• Required : cochez la case. 

• Default : entrez par exemple le mot-cle « SSII ». 

• Supply default : cochez la case. 

• Vocabulary : entrez par exemple les mots-cles « Conseil », « SSII », 
« Editeur », et « R&D », en allant a la ligne apres chaque entree. 

• Enforce Vocabulary : cochez la case. 

Creer les entrees de I'annuaire 

Une fois de plus, via l'interface publique du site, les membres identifies peuvent 
creer et publier du contenu correspondant au type que vous venez de mettre en 
oeuvre. 

Definir le nouveau type de contenu 

La phase suivante consiste a definir votre nouveau type de contenu au sein de 
l'outil portal _types du site CMF. Vous y ajoutez un objet Factory-based Type 
Information avec l'identifiant Dob par exemple, et les onglets Properties et 
Actions vous permettent de faire son parametrage. 

Proprietes du type 

A ce stade, les proprietes importantes a definir sont les suivantes : 

• Meta type : Job ; 

• Product name : ZoperaExtensions ; 

• Factory method in product : Job_add ; 

• Initial view name : job_edit_form. 

Vous voyez la le lien avec le produit ZClass que nous avons etudie plus haut. 

Actions associees au type 

Vous devez ensuite definir, sous l'onglet Actions du nouveau type, les trois prin- 
cipales actions d'edition du contenu : Taction de voir le contenu (view), celle de 
l'editer (edit), et celle de modifier ses metadonnees (metadata). 



RAPPEL Definition d'une action 

• Name : nom de Taction, tel qu'il apparaitra dans 
l'interface du CMF ; 

• Id : identifiant unique de Taction ; 

• Acti on : methode de I'objet invoquee par cette 
action ; 

• Permission: permission necessaire pour 
effectuer Taction ; 

• Category : categorie de Taction (object ou 
folder) permettant de situer Taction dans 
l'interface du CMF ; 

• Visible : cochez cette case pour que Taction 
apparaisse dans l'interface du CMF. Autrement, 
elle sera utilisable mais pas listee par defaut 
dans l'interface du CMF. 
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Void, resumes dans un tableau, les parametrages des differentes actions. 



„ . i ... Editer les 
Voir Editer _ . 

metadonnees 


Name 


Voi r 


Editer 


Meta-donnees 


Id 


view 


edit 


metadata 


Action 


job_view 


job_edit 


metadata_edit_form 


Permi ssion 


Vi ew 


Add Dobs 


Modify portal 
content 


Category 


Object 


Object 


Object 


Visible ? 


Oui 


Oui 


Oui 



ASTUCE 



Vous pouvez deplacer des actions vers le haut ou 
vers le bas (pour changer leur ordre d'affichage 
dans I'interface publique du site). 



Vous pouvez creer d'autres actions en plus des trois actions de base du type de 
contenu. La seule condition est de disposer, au sein de vos objets, d'une 
methode a inserer dans le champ Acti on. Par exemple, les objets de Zope dispo- 
sent d'une methode manage_mai n permettant d'afficher la page d'administration 
de Zope de l'objet concerne. Vous pouvez done creer une nouvelle action d'apres 
les informations suivantes : 
Name : Administrer ; 
Id : manage ; 
Action : manage_mai n ; 
Permission : View management screens; 
Category : object ; 
Visible : cochee. 



Utilisation d'Archetypes 



RAPPEL Qu'est-ce qu'Archetypes ? 

Archetypes est un framework fournissant des clas- 
ses de base et des services aux programmeurs 
pour creer de nouveaux types de contenu. II est 
ainsi nettement plus facile de creer, en partant de 
zero, des types complexes et relativement riches. 
Les avantages d'Archetypes sont bien entendu une 
tres grande facilite de prise en main, la richesse 
des outils proposes, mais aussi et surtout la force 
de la communaute participant au developpement 
d'Archetypes. 

La reference des champs et widgets Archetypes est 
donne dans I'annexe 3 de cet ouvrage. 



Archetypes est un outil plus que puissant pour simplifier la creation de produits 
sous Plone, permettant notamment d'ameliorer la qualite des developpements 
en reduisant le nombre de lignes de code necessaires. Desormais integre a Plone 
depuis sa version 2.0, il serait dommage de ne pas en profiter ! 
Nous allons nous attacher a la creation d'un type de contenu decrivant les objets 
vendus par la Societe Geniale. II ne s'agit pas de faire une boutique en ligne, 
mais juste une sorte de catalogue permettant d'identifier tous les articles que 
propose la societe. Le lecteur averti pourra bien entendu s'attacher a la realisa- 
tion d'une boutique. 

Commencezpar creer, dans le repertoire Products de Zope, un repertoire appele 
SCObject. II s'agira du nom de la classe que nous allons utiliser. 
Creez, a l'interieur de ce repertoire, un repertoire skins et un repertoire 
Extensions. Enfin, dans le repertoire skins, creez un sous-repertoire appele 
sgobject (en minuscules). Et e'est parti ! 
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Le principe de base 

La creation d'un produit base sur Archetypes est reduite a son minimum vital. 
Pour fournir un type de contenu, il faut les fichiers suivants : 

• le script d'initialisation du module ( i ni t . py) ; 

• la classe du type de contenu (nous l'appellerons SCOb j ect . py) ; 

• un script de configuration (appele conf i g . py) ; 

• un script d'installation du produit (Extensi ons/Instal 1 . py). 
Archetypes permet de definir tres simplement les champs qui vont etre portes 
par le contenu. Nous allons commencer par un exemple simple, avec juste les 
champs id, titre et une zone de texte quelconque. Void comment proceder. 

La configuration du produit 

Sauf mention contraire, les fichiers presentes ci-apres doivent etre places dans le 
repertoire Products/SCObject que vous venez de creer. Ainsi, le code suivant 
doit etre place dans le fichier config.py. II contient simplement des informa- 
tions permettant d'identifier le projet. 
Avant toute chose, nous importons quelques modules utiles. 

from Products. CMFCore.CMFCorePermissions import AddPortalContent, 
ModifyPortal Content 

from Products. Archetypes. uti is import DisplayList 

Puis, il convient de definir des informations relatives au projet, comme son nom, 
l'emplacement du repertoire des skins specifique au projet, le meta-type de la classe 
du contenu, et enfin une variable globale utilisee au moment de rinstallation. 

• General settings 
PRODECTNAME = "SCObject" 
SKINSJDIR = 'skins' 
PROJECTMETATYPE = "SCObject" 
CLOBALS = global s() 

Enfin, nous definissons les permissions necessaires pour creer et modifier les 
contenus de notre type. II s'agit ici des permissions standard de CMF, pour 
garder le modele le plus simple possible. 

• Permissions 

ADD_CONTENT_PERMISSION = AddPortalContent 
EDIT_CONTENT_PERMISSION = Modi fyPortal Content 

Le code d'initialisation du module 

Le code d'initialisation est charge par Zope lors de son demarrage. II doit gene- 
ralement contenir les declarations de base permettant a Zope de determiner 
queries classes sont utilisees par le produit. Avec Archetypes, le principe est tou- 
jours le meme, mais l'ecriture du code est plus simple. Placez, dans un fichier 
i ni t . py, le code suivant. 



Attention 

La fonction de rafraichissement (refresh) de pro- 
duits, bien connue des developpeurs Zope, fonc- 
tionne malheureusement tres mal avec 
Archetypes : elle est done a proscrire ! 
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Comme d'habitude, quelques imports bien sentis... 



from Global s import package_home 

from Products. Archetypes. public import * 

from Products. CMFCore. Di rectoryView import regi sterDi rectory 
from Products. CMFCore import utils 
import os, os.path 



Ah ! . . . nous faisons ici reference aux variables definies dans le fichier 
config.py. Celles-ci permettent au code d'initialisation d'etre commun a plu- 
sieurs produits. En effet, si vous voulez creer un nouveau produit base sur 
Archetypes, il vous suffira de dupliquer tout le code en changeant simplement 
les informations fournies dans config.py. C'est la que commence la veritable 
« reutilisabilite » ! 

from config import * 

La ligne de code suivante permet de declarer que les skins de notre produit sont 
contenues dans le repertoire skins (que vous avez du creer precedemment). 

regi sterDi rectory (SKINS_DIR,GLOBALS) 

Enfin, le code d'initialisation doit fournir une methode initialize contenant 
les procedures de declaration de notre type de contenu. La encore, i'utilisation 
de config.py rend ce code tout a fait reutilisable pour d'autres projets. Ce code 
ne presente d'ailleurs pas un enorme interet : il ne fait que s'appuyer sur l'API 
de Plone. Seule la ligne en gras revet une importance particuliere : elle permet 
d'initialiser notre type de contenu (nous verrons le module correspondant ulte- 
rieurement). 

def initialize(context) : 

# process our custom types 

import SCObject 

content_types , constructors, ftis = process_types( 

1 i stTypes (PROJ ECTNAME) , 

PROJECTNAME) 
utils. ContentlnitC 

PROJECTNAME + ' Content' , 

content_types = content_types , 

permission = ADD_CONTEN"T_PERMISSION , 

extra_constructors = constructors, 

fti = ftis, 

) .initialize(context) 

Le script (('installation 

Le script d'installation doit etre place sous Extensions/Instal 1 . py. II s'agit d'un 
bout de code relativement simple. Ce script a pour but de faciliter la tache de 
l'integrateur, en effectuant pour lui le travail de declaration des skins et du type 
de contenu sous Plone. Ce module est appele par le Quicklnstaller pour per- 
mettre l'installation facile du produit. 
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Voyons en detail, en commencant par notre sempiternelle liste d'imports : 

from Products. Archetypes. public import listTypes 

from Products. Archetypes. Extensions. utils import installTypes, 

install_subskin 

from Products. ArchExample.config import PROJECTNAME, CLOBALS 
from StringlO import StringlO 

La methode principale de ce module est install. C'est elle qui sera appelee par 
le Quicklnstaller pour effectuer les taches d'installation. 

def install (self): 
out = StringlOO 

La premiere chose a faire est d'installer les types de contenu dans l'outil 
portal_types : c'est la methode installTypes qui s'en charge. 

install Types (self, out, listTypes (PROJECTNAME) , PROJECTNAME) 

Enfin, il convient de declarer la skin au sein de l'outil portal_ski ns. Ici, c'est la 
methode install_subskin qui realise le travail 

install_subskin(self , out, CLOBALS) 

Afin d'afficher, dans le Quicklnstaller, un gentil message de confirmation, nous 
utilisons un fichier en memoire (StringlO). C'est une chaine de caracteres qui 
possede le comportement d'un fichier. Autrement dit, cela permet d'utiliser les 
methodes write et getvalue pour respectivement ajouter du contenu ou lire le 
contenu de la chaine. Ce module n'est utilise que pour le message affiche par 
Quicklnstaller et nous ne le decrivons qua l'attention du lecteur curieux ! 

out.write("Successfully installed %s." % PROJECTNAME) 
return out.getvalue() 

La classe du produit 

Cette classe est fondamentale pour notre etude. C'est elle, en effet, qui est porteuse 
de toutes les informations reellement specifiques a notre type de contenu. Autant les 
fichiers precedents servent surtout de « fioritures », autant le module qui porte cette 
classe est celui dans lequel vous passerez le plus de temps a coder. Commencons par 
notre exemple tout simple d'un type de contenu portant juste un titre et une descrip- 
tion. Comme d'habitude, nous commencons par. . . les imports ! 

from Products. Archetypes. public import * 

from Products. Archetypes. BaseContent import BaseContent, 

BaseContentMixin 

from Products. Archetypes. uti Is import DisplayList 
from Products. CMFCore import CMFCorePermissions 
from config import * 

from AccessControl import ClassSecuritylnfo 
import string 



A Les schemas 

Sous Archetypes, les types de contenu sont 
decrits par des schemas. Un schema est une 
liste de definition de champs avec, pour chaque 
champ, une expression de son identifiant, de 
son type, de son titre, et du composant utilise 
pour afficher ou editer sa valeur. On peut speci- 
fier beaucoup d'autres choses dans un schema, 
comme nous le verrons plus loin. 



Archetypes... la tete contre les murs 

Les nombreuses qualites d'Archetypes ne sau- 
raient dissimuler un defaut : son extreme rigueur 
syntaxique et la pauvrete des messages d'erreur 
ou d'avertissement qu'il peut produire lors de la 
creation d'un produit. II suffit d'une parenthese 
mal placee, d'un guillemet oublie, d'une ligne de 
code omise pour empecher votre type de contenu 
d'apparaitre dans la liste deroulante du back- 
office de Plone. Si cela vous arrive, vous aurez 
beau chercher rationnellement dans la traceback de 
Zope, vous ne trouverez rien : Archetypes a 
« avale » silencieusement votre type de contenu. 
Dans un pareil cas, adoptez une demarche 
rationnelle : reprenez chaque bout de code, veri- 
fiez si vous n'avez rien oublie. L'erreur est force- 
ment quelque part ! Si cela vous arrive apres une 
modification de votre produit, surveillez attentive- 
ment les lignes de code que vous avez modifiees. 
Enfin, nous ne saurions trop rappeler que I'utilisa- 
tion d'un serveur CVS dans I'ecriture d'un produit 
peut etre salvatrice a bien des titres ! 



Void maintenant la partie la plus interessante : le schema. C'est ici que nous 
decrivons les differents champs de notre type de contenu. 
La ligne suivante decrit simplement un champ de type texte appele 
« Description de l'objet », represente par une balise TextArea, obligatoire et dont 
la valeur est stockee dans l'attribut body de la classe et cataloguee. Voyons plutot 
(attention aux parentheses, elles sont toutes obligatoires !) : 

schema = Schema( 
( 

TextField( 
'body' , 
searchable=l, 
requi red=l, 

widget=TextAreaWidget( 

label="Descn'ption de l'objet", 
), 

), 

)) 

Et voila. Le schema est defini. II reste encore a creer le corps de la classe. . . Void 
toute la puissance d'Archetypes resumee ici en deux lignes de code (attention 
aux yeux, c'est eblouissant) : 

class SCObject(BaseContent) : 

schema = BaseSchema + schema 

Juste pour la forme : outre la declaration de l'utilisation du schema defini ci- 
dessous, nous declarons au passage que la classe se base egalement sur 
BaseSchema, qui est le schema standard d'Archetypes definissant les champs 
« identifiant » et « titre » (autrement dit, les champs dont vous aurez sans arret 
besoin !). Car, oui, les schemas peuvent etre concatenes aussi simplement qu'un 
tuple Python... Nous verrons plus loin que Ton peut meme faire beaucoup plus 
avec ces fameux schemas. 

Enfin, il convient d'enregistrer ce nouveau type de contenu : 
regi sterType(SGObject) 

Et voila. C'est fini. Nous n'avons pas cree une seule ZPT, car Archetypes va s'en 
charger pour nous. Redemarrez Zope, allez dans Quicklnstaller, installez 
Archetypes si fa n'est pas deja fait, puis installez votre produit. Vous pouvez 
maintenant aller dans Plone et constater qu'il fonctionne a merveille ! 

Etendre le schema 

Notre schema est certes concis, mais surtout notoirement insuffisant ! Nous 
cherchons a decrire des objets vendus par la societe, et il convient de leur ajouter 
nombre d'informations pertinentes, comme leur description, leur prix, ou meme 
une categoric Nous allons done etendre le schema presente ci-dessus pour 
ajouter les champs pertinents. 
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schema = Schema( 
( 

TextField( 
'body' , 

searchable = 1, 

required = 1, 

wi dget=TextAreaWi dget ( 

label="Description de l'objet", 

), 

), 

Sous la description de l'objet (les champs d'Archetypes sont ordonnes), nous 
pouvons ajouter, par exemple, un prix. Ici il ne s'agit plus d'un champ de type 
texte mais d'un entier. Archetypes fournit une liste de champs suffisamment 
riche pour y trouver son bonheur. Ici, le champ est mentionne comme indexe 
(searchable) et obligatoire (required). 

En se basant sur l'exemple du champ precedent, nous pouvons ecrire le morceau 
de code suivant : 

FloatFieldC 
"price", 
searchable = 0, 
requi red = 0, 
default =0.0, 
widget = StringWidget( 

label = "Prix de l'objet", 

), 

), 

Ici, nous mentionnons que le champ n'est pas obligatoire (requi red=0) et que sa 
valeur ne doit pas etre cataloguee (searchable = 0) : cela ha aucun sens de 
rechercher un prix dans le moteur de recherche du site ! Nous avons ajoute une 
mention pour forcer une valeur par defaut a 0 pour ce champ. Enfin, ce prix est 
saisi dans une zone d'edition classique, ce que nous appelons StringWidget. Le 
label, comme nous l'avons constate avec l'exemple precedent, est l'intitule du 
champ tel qu'il apparait dans les ecrans. 

Plus fort encore : nous pouvons ajouter une image. Archetypes fournit i'attirail 
necessaire pour la gestion simple d'une image dans un type de contenu, comme 
le montre la suite de notre nouveau schema : 

ImageField( 
"photo" , 

widget = ImageWidget( 

label = "Photo de l'objet", 
), 

), 

)) 

Une fois ces modifications effectuees, relancez Zope : vous constatez alors que 
les nouveaux champs sont automatiquement pris en compte, et qu'il est facile 
d'ajouter un prix et une image pour vos contenus de type objet. La vie est belle ! 



//. Field et Widget 

Archetypes utilise, pour la description de ses 
schemas, deux notions fondamentales : les 
champs (Fields) et les zones visuelles 
(Widgets). Un champ est la definition de la 
maniere dont est stocke et gere le contenu par 
la classe, en particulier s'il est obligatoire, s'il 
doit etre indexe, son nom, les valeurs qu'il lui 
est possible de prendre, etc. Un widget est la 
definition de la maniere dont le champ est affi- 
che, tant en saisie qu'en modification. Un 
champ de type texte, par exemple, pourrait etre 
edite dans un input HTML classique ou dans 
une zone de texte (TextArea). Le program- 
meur a la possibility de forcer I'un ou I'autre cas 
en specifiant le wi dget du champ. 



ASTUCE Les valeurs par defaut 
des attributs des champs 

En toute rigueur, dans le cas du FloatField, il 
n'est absolument pas necessaire de specifier 
searchable=0 ou requi red=0 : chaque 
champ utilise des valeurs par defaut pour ses diffe- 
rentes options de configuration, et, dans le cas du 
FloatField, ces proprietes sont positionnees 
telles que nous I'aurions souhaite. 



Redemarrage de Zope 
et modifications du schema 

Dans tous les cas, Archetypes se charge de I'initia- 
lisation de votre produit au moment du demarrage 
de Zope. Autrement dit, une fois que vous avez 
installe une fois votre produit avec le Quicklnstal- 
ler, il n'est pas necessaire de le reinstaller lorsque 
vous modifiez votre code. Pire : si votre code com- 
porte une erreur, vous pouvez rendre votre Plone 
instable en tentant de desinstaller un produit qui 
ne fonctionne pas ! 

Si votre code comporte des erreurs, il se peut que 
votre type de contenu « disparaisse » de 
portal_types. Dans ce cas, concentrez-vous sur 
vos modifications, corrigez votre code, mais 
n'incriminez pas Quicklnstaller et ne tentez pas 
non plus de desinstaller ou reinstaller votre produit 
a la main. 
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Exploiter la richesse d'Archetypes 

Les possibilites d'Archetypes sont bien plus grandes que la simple definition de 
quelques champs. Nous allons, dans la section qui suit, exposer quelques unes 
des options offertes pour augmenter la productivite des developpeurs. 

Les differents types de champs et widgets 

Nous avons vu qu'il etait possible, avec les champs d'Archetypes, de creer des 
champs tres simples (zone de texte, par exemple), comme des champs beaucoup 
plus complexes. Voici une liste de types de champs, presentes dans des exem- 
ples, qui vous donneront une idee de l'efficacite d'Archetypes. Nous allons done 
etendre notre schema avec les exemples suivants. 

D'abord, nous avons la possibilite de placer un fichier dans notre type de con- 
tenu. II est possible, par exemple, d'associer un fichier de description, un docu- 
ment Word, etc. Archetypes ne se charge pas de Interpretation du fichier 
attache, mais le composant PloneArticle permet d'etendre Archetypes pour 
proposer une indexation du contenu et un apercu directement en HTML. 

FileField( 
"fichier" , 

widget = FileWidget( 

label = "Fichier attache", 
), 

), 

II est possible de proposer des champs de gestion de la date : ceux-ci seront affi- 
ches d'une maniere particulierement elegante, avec une saisie de la date dans un 
calendrier cree en JavaScript. La definition d'un tel champ est d'une simplicite 
enfantine : 

DateTimeField( 

"shipping_date", 

widget = CalendarWidget( 

label = "Date de sortie du produit", 
), 

), 

On peut egalement utiliser un champ de type booleen, comme ceci : 

BooleanField( 
"obsolete" , 

widget = BooleanWidget( 
label = "Obsolete", 

description = "Cliquez ici si ce produit n'est 
plus disponible", 

), 

), 



Notez au passage la ligne description, qui permet d'ajouter un texte dans les 
formulaires d'edition des valeurs. Ceci est tres pratique pour ajouter un texte 
d'explication a un champ complexe. 

Enfin, il existe un champ tres pratique pour afficher une valeur issue de l'execu- 
tion d'une methode. Void un exemple simple : 

ComputedField( 
"auteur" , 

widget = StringWidget( 

label = "Auteur du document", 
), 

accessor = "Creator", 
), 

Nous avons ici cree un champ calcule, qui sera visible mais pas modifiable. Sa 
valeur est donnee par l'attribut accessor : il s'agit du resultat de l'appel de la 
methode Creator qui, pour un type de contenu donne, renvoie l'identifiant de 
son auteur. 

En fait, il est possible d'utiliser l'attribut accessor sur himporte quel champ. De 
meme, il est possible de rendre n'importe quel champ en lecture seule en lui spe- 
cifiant l'attribut : 

mode = ' r ' 

Et de meme, on peut rendre un champ en mode ecriture seule (il n'apparaitra 
pas pour les lecteurs) en specifiant l'attribut : 

mode = 'w' 

Liste de valeurs (vocabulaire) 

Enfin, un dernier type de champ est la selection dans une liste. La seule diffi- 
culte technique reside dans le fait que, pour un tel champ, il est indispensable de 
mentionner la liste de valeurs possibles. Void le code correspondant : 

StringField( 
"etat", 

vocabulary = "getEtats", 
widget = SelectionWidget( 

label = "Etat de 1 'objet", 

), 

La zone de selection est restreinte au vocabulaire mentionne par l'attribut 
vocabul ary. II faut definir la methode getEtats dans le corps de la classe du type 
de contenu pour que tout cela fonctionne. Rien de plus facile : 

security = ClassSecuritylnfoO 
securi ty . dec! arePubl i c ("getEtats") 



o 




def getEtats(self ,): 
"getEtats" 

return DisplayList(( 



("1", "Etude", ), 

("2", "Prototype", ), 

("3", "Fabrication en serie", ), 

("4", "Ecoulement du stock", ), 

("5", "Epuise", ), 

)) 



Nous declarons une methode publique, qui retourne un objet de type 
DisplayList : il s'agit d'un type utilise par Archetypes pour representer des 
listes de selection sous forme de paire cle/valeur. Ainsi, dans l'exemple ci- 
dessus, la cle sera le numero passe en parametre. 
Redemarrez Zope, et admirez votre nouveau type de contenu ! 



II est possible, avec Plone, de creer ses propres types de contenu pour etendre le 
modele de donnees deja disponible. La creation d'un type de contenu peut se 
faire par duplication d'un type existant - il s'agit la du cas le plus simple, mais 
aussi du plus limite. Le programmeur peut egalement ecrire une ZClass pour 
son nouveau type : il s'agit d'un mecanisme permettant de creer rapidement de 
nouvelles classes dans Zope, mais cette technique est tombee en desuetude au 
profit de l'ecriture de produits Python. II peut etre fastidieux d'ecrire des pro- 
duits complets pour des types de contenu structures de la meme maniere : pour 
cela, Archetypes repond efficacement aux besoins de la plupart des deve- 
loppeurs. Avec Archetypes, il est simple et rapide de partir d'un modele de base 
pour l'etendre au gre des besoins. 



En resume... 



110 



Mise en production 
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Utilisateur 




Nous sommes maintenant prets a faire migrer le site sur un serveur de production. 
Ce chapitre nous donne des informations complementaires pour aller plus loin 
dans la mise en ceuvre d'un systeme de haute performance reposant sur Zope. 



Line bonne installation est fondamentale 



Bien installer le systeme, c'est se garantir des le debut que Ton va se simplifier la 
tache pour sa maintenance. En effet, en reduisant au maximum les risques 
d'incidents de production pour l'exploitant, on se met en position de faire durer 
le site longtemps et done d'aider a la perennite du projet. Pour ce faire, nous 
allons respecter un certain nombre de regies fondamentales. 

Nous allons notamment assurer une separation franche entre Python, Zope et 
les instances (les composants propres et les donnees ). 

De plus, pour chaque instance de Zope, nous allons garantir la separation 
franche entre : 

• les donnees (data. fs notamment) ; 

• les produits propres a l'instance ; 

• les fichiers de logs ; 

• les fichiers de configuration. 

En respectant ces principes, il est aise d'effectuer les taches de maintenance : 
identifier les elements a sauvegarder regulierement, mettre a jour un site d'une 
version de Zope a l'autre, etc. 

Autant les versions 2.6 et anterieures etaient difficiles a bien mettre en ceuvre 
sur ces points, autant les versions 2.7 et superieures proposent des outils ideaux 
pour ces taches. 

En effet, depuis Zope 2.7, rinstallation ne melange plus le moteur de Zope avec 
les donnees de l'instance installee. 

Zope 2.7 propose de facto l'arborescence d'installation du type : 

/Zope-2.7 
/bin 
/doc 
/lib 

/python 
/Products 

I- 

/i nstances/ 
/instancel 

/Extensions 

/Products 

/bin 

/etc 

/import 

/log 

/var 
/instance2 

/Extensions 

/Products 

/bin 



/etc 
/import 
/log 
/var 

I- 

A. 



Installation d'un site en production 



Preparation de la plate-forme 

Le present chapitre couvre l'installation d'un site Zope sous Unix. Les lecteurs 
qui utilisent MS-Windows pour une mise en production adapteront ces explica- 
tions a leur environnement. 

Hypothese est faite que l'utilisateur a a sa disposition un serveur Unix fraiche- 
ment installe. Les auteurs recommandent les Unix libres comme Linux ou les 
systemes BSD. Zope est connu pour egalement parfaitement fonctionner sous 
Mac OS X, Solaris, AIX et autres versions d'Unix. 

Installation des paquetages logiciels principaux 

Sur une plate-forme Linux Debian, ces elements s'installent tres simplement 
avec les commandes (en tant que root) : 

$ apt-get update 

$ apt-get install wget 

| $ apt-get install gcc 

$ apt-get install make 

$ apt-get install automake 

$ apt-get install libc6-dev 

$ apt-get install python2.3 

$ apt-get install python2 . 3-dev 

$ apt-get install locales(choisi r fr_FR ISO-8859-1 dans le menu a 
1' install) 
$ locale-gen 



ATTENTION Distributions 

Attention a Zope sous MS-Windows, au moins 
jusqu'a la version 2.6.1. En effet, compile avec 
les outils Microsoft Visual Studio, Python 2.1.3 
n'accepte pas les fichiers de plus de 2 Go ; la 
base de donnees de Zope souffrira alors de ce 
handicap. La version 2.6.2, qui fonctionne avec 
Python 2.3.2, est censee corriger cette limita- 
tion. 

La distribution Redhat 7.x est connue pour 
poser des problemes insolubles de dependances 
entre paquets si Ton utilise les RPMs. Redhat 9.x 
fonctionne parfaitement. Debian est recomman- 
dee pour ses qualites de facilite de deploiement 
grace au systeme de gestion de paquets APT. 



Suivant la « fraTcheur » de votre Debian, vous pou- 
vez etre amene a installer certains paquets 
(notamment python2.3) depuis la source 
testing. 



Sur une plate-forme FreeBSD, l'installation de ces memes paquets se fait avec 
(en tant que root) : 

$ cd /usr/ports/ftp/wget && make install clean 
$ cd /usr/ports/lang/python && make install clean 



Les autres paquets sont deja installes en standard sur cette plate-forme. 
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Dans la version MS-Windows du produit 
ZAAPlugins, ces complements sont directement 
livres sous une forme binaire : aucune installation 
de ces logiciels n'est done a prevoir sous MS- 
Windows. De meme, la presence de Microsoft 
Office ou Adobe Acrobat n'est pas requise. 



Installation des autres paquetages logiciels 

Les paquets suivants sont optionnels mais seront necessaires, notamment pour 
indexer le contenu des fichiers bureautiques ou travailler avec des images sur le 
site : 

$ apt-get install python2 . 3-imagi ng 

$ apt-get install wv 

$ apt-get install xlhtml 

$ apt-get install xpdf 

$ adduser zope 

Adding user zope. . . 

Adding new group newbie (1001). 

Adding new user newbie (1001) with group zope. 

Creating home directory /home/zope. 

Copying files from /etc/skel 

Changing password for zope 

Enter the new password (minimum of 5, maximum of 8 characters) 
Please use a combination of upper and lower case letters and numbers. 
Re-enter new password: 
Password changed. 

Changing the user information for newbie 

Enter the new value, or press return for the default 

Full Name [] : Zope Virtual User 

Room Number [] : 

Work Phone [] : 

Home Phone [] : 

Other [] : 

Is the information correct? [y/n] Y 

Installation de Zope 
Utilisateur Zope 

Commencons par ajouter un utilisateur zope a notre systeme (en tant que root) : 
Nous voila done avec un nouvel utilisateur zope, pour lequel nous aurons pris 
soin de choisir un mot de passe bien complique. 

Le moteur de Zope 

Nous allons maintenant installer le moteur de Zope. Premier point : connec- 
tons-nous en tant qu'utilisateur zope : 

$ su - zope 
zope$ mkdir sre 
zope$ cd sre 

Puis, avec ce nouvel utilisateur, telechargeons l'archive de Zope (ici la 2.7.0) : 
zope$ wget http://zope.Org/Products/Zope/2.7.0/Zope-2.7.0.tgz 
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Decompressons l'archive : 

zope$ tar xvzf http://zope.Org/Products/Zope/2.7.0/Zope-2.7.0.tgz 
zope$ cd Zope-2.7.0 

Compilons : 

zope$ ./configure — optimize --prefix=/home/zope/Zope2.7 
zope$ make 

La compilation prend quelques minutes. On peut ensuite installer Zope : 
zope$ make install 

Nous disposons maintenant d'une version du moteur de Zope installe dans le 
repertoire /home/zope/Zope2 . 7. 

Une premiere instance de Zope 

Notre instance va s'appeler (de maniere tres originale) pi onel. 
En tant qu'utilisateur zope, creons pi onel : 

zope$ cd 

zope$ mkdir instances 

zope$ Zope2.7/bin/mkzopeinstance.py --di r=instances/plonel 

Ce script demande de choisir l'identifiant et le mot de passe de l'administrateur 
de l'instance : 

Username: admin 
Password : ******* 

Voila : notre instance est installee ! 

Interessons-nous maintenant au fichier de configuration de Zope. 

Fichier de configuration 

Le fichier de configuration de Zope 2.7 a le merite d'etre particulierement com- 
plet et clair (surtout pour les personnes qui ont connu les versions 
precedentes !). 

Ce fichier de configuration, zope.conf, se situe dans le repertoire etc de notre 
instance, soit dans notre cas : 

/home/zope/i nstances/plonel/etc/zope . conf 

Ce fichier contient un grand nombre de sections et de parametres, qui depassent 
le cadre du present ouvrage. Cependant, nous allons presenter les parametres les 
plus importants a connaitre. 



ZOOM Les fichiers d'une instance Zope 

La structure des fichiers d'une instance Zope est la suivante. 

/Extensions - Les methodes externes [External Method) de I'instance sont a deposer ici. 
/Products - C'est dans ce repertoire que sont installes les produits Zope de I'instance. 
L'installation de Zope apporte deja de nombreux produits standards, qui restent stockes 
dans le repertoire d'installation de Zope. Done, meme si le repertoire Products de I'ins- 
tance reste vide, les produits standards de Zope sont presents. 

/bi n - Ce repertoire contient tous les executables de I'instance, notamment zopectl (ou 
runzope . bat pour MS-Windows), qui permet de demarrer et arreter I'instance. 
/etc - Ce repertoire contient les fichiers de configuration de Zope. Le plus important est 
zope . conf, detaille plus loin dans cet ouvrage. 

/i mpo rt - C'est dans ce repertoire que Ton depose les fichiers d'export Zope ( . zexp) des- 
tines a I'instance. 

/I og - Ce repertoire contient tous les fichiers de logs de I'application Zope. Le plus utile est 
events.log, qui va garder trace de tous les messages importants du serveur. La produc- 
tion des logs est configuree dans le fichier etc/zope . conf de votre instance, 
/var - Ce repertoire contient les fichiers fondamentaux suivants, crees au premier 
lancement : data.fs (la base de donnees objet, fichier principal a sauvegarder), Z2.log 
(I'ensemble de toutes les requetes traitees par le serveur Web de Zope, rarement utilise) et 
Z2 . pi d (le numero du processus Zope, si celui-ci est lance). 



debug-mode 

• Usage (au choix) : debug-mode on (valeur par defaut) ou debug-mode off. 

• Definit si Zope tourne en mode debug ou non. 

• II convient de laisser le mode debug pendant la phase de developpement et 
de test, et de le retirer des la mise en production. 

• Attention : en mode debug, Zope est 2 a 6 fois plus lent qu'en mode normal ! 

effective-user 

• Usage : effective-user zope. 

• Specifie le nom de l'utilisateur qui sera proprietaire du processus Zope, dans 
le cas oii ce dernier est demarre par root. C'est utile pour le cas ou les pro- 
cessus Zope sont lances au demarrage de la machine. 

locale 

• Usage (au choix) : 1 ocal e fr_FR (pour Debian) ou locale f r_FR.ISO-8859-l 
(pour FreeBSD). 

• La locale est le nom de la page de code qu'utilise I'instance. En termes plus 
clairs, cette valeur designe les jeux de langue avec lesquels on manipule le 
site ; pour pouvoir utiliser les caracteres accentues du francais, nous posi- 
tionnons la locale sur le jeu francais. 



port-base 

• Usage : port-base 8000. 



• Definit les ports utilises pour les serveurs HTTP, FTP et WebDAV en une 
seule commande. 

• Les ports sont alors definis comme suit: port_base + 80 (HTTP), port- 
base + 90 (WebDAV) ou port-base + 21 (FTP). 

datetime-format 

• Usage (au choix) : datetime-format international (recommande) ou 
datetime-format us (par defaut). 

• Precise le format des dates telles que manipulees par Zope. Le format inter- 
national est recommande. 

Pour les autres champs, le fichier zope.conf par defaut contient la liste exhaus- 
tive, sa lecture est ties instructive. 

Installer les produits necessaires 

Notre instance de Zope est maintenant prete. Installons-y les composants Zope 

necessaires a notre site Plone. 

Voici la liste des composants de base recommandes : 

• Plone 2.0 ; 

• Epoz 0.8.x ; 

• ImageTag_CorePatch 0.3; 

• PloneArticle 2.0 ; 

• PloneExFile 2.0 ; 

• ZAttachmentAttributes 2.0; 

• ZAAPlugins 2.0 ; 

• PloneSearchBox 2.0; 

• PloneSiteMap 2.0. 

Pour les installer, il faut les telecharger sur Internet et les decompresser directe- 
ment dans le repertoire Products de l'instance. 

En tant qu'utilisateur zope, creons un espace pour telecharger les composants : 
zope$ cd 

zope$ cd instances/plonel 
zope$ mkdir tmp 
zope$ cd tmp 

Toujours en tant qu'utilisateur zope, rapatrions les fichiers necessaires : 

zope$ wget http://umn.dl.sourceforge.net/sourceforge/plone/ 

*»CMFPlone-2.0.tar.gz 
zope$ wget http://mjablonski . zope. de/Epoz/releases/Epoz-0. 8.0. tar. gz 
zope$ wget http://zope.Org/Members/bowerymarc/ImageTag_CorePatch/0. 3/ 
zope$ wget http://umn.dl .sourceforge.net/sourceforge/ingeniweb/ 

*»P1 oneArti cl e-2 . 0 . tar . gz 
zope$ wget http://umn.dl .sourceforge.net/sourceforge/ingeniweb/ 

^••PloneExFi le-2 .O.tar.gz 



Bien entendu, ces URL seront amenees a etre 
adaptees a la lumiere des nouvelles versions pro- 
posees de ces composants. Le support papier pos- 
sede la ses limites :-) 
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zope$ wget http://umn.cn .sourceforge.net/sourceforge/ingeniweb/ 

*»ZAttachmentAtt ri bute-2 . 0 . tar . gz 
zope$ wget http://umn.di .sourceforge.net/sourceforge/ingeniweb/ 

*ZAAP1 ugi ns-2 . 0 . tar . gz 
zope$ wget http://umn.dl .sourceforge.net/sourceforge/ingeniweb/ 

*»PloneSearchBox-2 .0.tar .gz 
zope$ wget http://umn.di .sourceforge.net/sourceforge/ingeniweb/ 

*P1 oneSi teMap-2 . 0 . tar . gz 

Enfin, installons ces fichiers correctement dans le repertoire Products : 

zope$ tar xvzf CMFPlone-2.0.tar.gz 

zope$ mv CMFPlone-2 .0/* ../Products 

zope$ cd ../Products 

zope$ tar xvzf . ./tmp/Epoz-0.8.0.tar.gz 

zope$ tar xvzf . ./tmp/ImageTag_CoreTag-0.3.tar.gz 

zope$ tar xvzf . ./tmp/PloneArticle-2.0.tar.gz 

zope$ tar xvzf . ./tmp/PloneExFiie-2.0.tar.gz 

zope$ tar xvzf . ./tmp/ZAttachmentAttri bute-2. 0. tar. gz 

zope$ tar xvzf . ./tmp/ZAAPi ugi ns-2. 0. tar. gz 

zope$ tar xvzf . ./tmp/PloneSearchBox-2.0.tar.gz 

zope$ tar xvzf . ./tmp/PloneSiteMap-2.0.tar.gz 

Tous les fichiers necessaires sont en place : demarrons (enfin) notre instance ! 

Demarrer I'instance 

Demarrons notre instance, en tant qu'utilisateur zope : 

zope$ instances/plonel/bin/zopectl start 
daemon process started, pid 8789 

On peut tester le site avec son navigateur (figure 8-1). 

Pour redemarrer une instance depuis la ligne de commande (dans le cas de l'ins- 
tallation d'un produit par exemple) : 

zope$ instances/plonel/bin/zopectl restart 
daemon process restarted, pid 8876 

Arreter I'instance 

Pour arreter notre instance, en tant qu'utilisateur zope, il suffit de saisir les lignes 
suivantes : 

zope$ instances/plonel/bin/zopectl stop 
daemon process stopped 



Zope QuickStart 
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Zope Quick Start 

Welcome to Zope, a high-performance object-oriented platform for building dynamic Web applications. Here are some quick pointers to 
get you started: 

• Read The Fine Manual. This document guides you through the whole process of learning Zope, from logging In for the first time to 
creating your own web applications. 

• There is a built-in interactive Zope Tutorial which gets you started with some simple tasks using the Zope managment Interface. 
To use the tutorial, go to any Folder and select Zope Tutorial from the add list and click the Add button. Provide a name for the 
tutorial and click Add to begin working with the tutorial. 

• Import and then check out the new example Zope applications. These examples show you simple working Zope applications that 
you can copy and modify. 

• Go to the main Documentation Overview on Zope.org. Here you wilt find pointers to official and community contributed 
documentation. 

• Look at the various Mailing Lists about Zope. The Mailing Lists are where you can get quick, accurate, friendly help from a large 
community of Zope users from around the world. 

• Browse and search the integrated. Online Help System which contains documentation on the various kinds of components you'll 
find in Zope. 

• Go directly to the Zope Management Interface if you'd like to start working with Zope right away. NOTE: Some versions of 
Microsoft Internet Explorer, (specifically IE 5.01 and early versions of IE 5.5) may have problems displaying Zope 
management pages. If you cannot view the management pages, try upgrading your IE installation to the latest release 
version, or use a different browser. 

• Find out about Zope Corporation, the publishers of Zope. 



Figure 8-1 

Test du site 



Fichiers de demurrage 

Pour faire en sorte que toutes les instances zope se mettent en route spontane- 
ment au redemarrage de l'ordinateur et s'arretent proprement a l'arret du ser- 
veur, il nous faut preparer un script adapte : 

#!/bin/sh 

ZOPEHOME=/home/zope 
ZOPEINSTANCES=$ZOPEHOME/instances 
for instance in 'Is $ZOPEINSTANCES' 
do 

$ZOPEINSTANCES/$i nstance/bi n/zopecti $1 
done 

Ce script, intitule zope.sh, est a placer dans /home/zope et doit etre executable : 
j zope$ chmod a+x zope.sh 

Enfin, pour ajouter ce script aux scripts de demarrage de notre serveur, tapez les 
lignes suivantes en tant que root : 

$ cp /home/zope/zope.sh /etc/init.d/ 
$ chown root: root /etc/init.d/zope.sh 
$ chmod 755 /etc/init.d/zope.sh 
$ update-rc.d zope.sh defaults 
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Frontal Apache 



Attention 

Apache est traditionnellement un processus lance 
a partir de root, qui fork (cree un processus fils) le 
serveur en user Nobody a son lancement. Si le 
compte Nobody est deja utilise, il est conseille de 
creer un nouveau compte, specifique a Apache, par 
exemple apache. 



Nous allons utiliser Apache pour servir les pages Web du serveur Zope. Zope 
nest alors utilise que comme simple serveur d'application. Certaines subtilites 
sont detaillees plus loin dans ce chapitre. 

La version d'Apache retenue est la version 1.3. A l'heure ou nous ecrivons ces 
lignes, la version 2 presente des problemes dans son module de gestion du 
cache, qui l'ecartent d'une mise en production. 
Le repertoire de base recommande est : 

/usr/local/apache 
Le proprietaire (owner) du repertoire doit etre l'utilisateur root. 

Compilation et installation 

En tant qu'utilisateur normal, tapez les commandes suivantes : 

$ wget http : //apache . i -connexi on . net/di st/httpd/apache_l . 3 . 27 . tar . gz 
$ tar xvzf apache-1.3.27.tar.gz 
$ cd apache-1. 3. 27. tar. gz 

$ ./configure — prefix=/usr/local/apache --with-layout=Apache — 
enabl e-modul e=al 1 — enabl e-shared=max 

Avec ces commandes, on prepare la compilation dApache avec les specifica- 
tions suivantes : 

1 Installation dans /usr/local. 

2 Utilisation du schema de repartition des fichiers Apache ; tous les fichiers 
seront dans les repertoires dApache, notamment : 

- conf : fichiers de configuration ; 

- htdocs : fichiers HTML a servir ; 

- proxy : emplacement pour les fichiers temporaires du proxy-cache. ; 

- bin : binaires dApache (dont apachectl et httpd) ; 

- cgi-bin : emplacement des scripts CGI, si necessaire ; 

- include : les .h ; 

- 1 i b : les librairies ; 

- 1 ogs : les fichiers de logs ; 

- modules : les modules Apache dynamiques. 

3 Les modules suivants sont actives : 

- RewriteRule: permet de manipuler les URL des pages renvoyees par 
Zope ; 

- Proxy : permet de servir de proxy entre le serveur Zope et le client ; 

- Headers : permet d'ajouter des en-tetes aux requetes HTTP servies par le 
proxy ; 

- SSL : le module SSL est inclus dans Apache 2. 
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Enfin, la compilation et l'installation se font avec : 

$ make -DEAPI 

$ sudo make install 

La phase d'installation (make install) est operee avec l'utilisateur root via 
sudo : c'est le seul utilisateur qui ait le droit d'ecrire des fichiers dans le reper- 
toire /usr/local de deploiement. 

Configuration d'Apache 

Le fichier httpd.conf fourni avec Apache (/usr/local/conf/httpd.conf) est a 
analyser et a corriger en fonction de la machine et des sites heberges. 
On peut notamment ajouter, en fin de fichier : 

NameVirtualHost * 
Include conf /www. monsi te.com. conf 
Include conf/www.monsite.com.ssl .conf 
Include conf /www. monautresite.com. conf 

Ainsi, on cree autant de fichiers de configuration que de Vi rtualHost, simpli- 
fiant la maintenance et les eventuelles migrations. 

VirtualHosting HTTP 

Voici un exemple de fichier www.monsite.com.conf : 

<Vi rtualHost *> 

# Virtual Host Monster handling 
Serve rName www.monsite.com 
ServerAlias monsite.com 
ServerAlias www2.monsite.com 
ServerAdmi n support@i ngeni web . com 
RewriteEngine on 

RewriteCond %{HTTP:Authorization} 

RewriteRule a(.*) http : //local host : 8080/Vi rtualHostBase/http/ 
*-%{HTTP_HOST} : 80/zopepath/to/www . monsi te . com/Vi rtual HostRoot/ 
+■$1 [P] 

CacheRoot "/usr/local/apache/proxy" 
CacheSize 15000 
CacheCcInterval 2 
CacheMaxExpi re 24 
CacheLastModifiedFactor 0.1 
CacheDefaultExpi re 1 
CacheDi rLength 2 
# 

# Expire - by request 
# 

Expi resActi ve On 
Expi resByType image/gif A86400 
Expi resByType image/png A86400 
Expi resByType image/jpeg A86400 



OUTILS Analyse des logs 

Le lecteur curieux regardera du cote des excellents 
Webalizer : 

► http://www.mrunix.net/webalizer/ 
et AWStats : 

► http://AWStats.sourceforge.net 



Expi resByType text/ess A86400 
Expi resByType text/javascript A86400 
Expi resByType application/x- javascript A86400 
CustomLog logs/www. monsite.com. access. log combined 
ErrorLog logs/error. log 
</Vi rtual Host> 

Les elements importants a noter sont : 

• RewriteRule : responsable de l'echange des informations avec Zope ; e'est la 
fonction proxy d'Apache ; 

• CacheRoot : activation de la fonction cache d'Apache ; toutes les pages deja 
servies par Apache et qui sont demandees par un navigateur - pas forcement 
le meme - sont alors servies directement par Apache, sans sollicker Zope ; 

• CustomLog : creation des fichiers de log, pour analyse par un outil adapte, 
afin de mesurer la frequentation du site. 

Validation de la configuration 

Avant de demarrer Apache, il est recommande de tester la configuration avec : 
/usr/1 ocal /apache/bi n/apachectl conf i gtest 

Les regies de Vi rtual Hosting sont analysables grace a : 
/usr/1 ocal /apache/bi n/apachectl -S 

Demarrage d'Apache 

Pour demarrer le serveur HTTP, en tant qu'utilisateur root, utilisez la com- 
mande suivante : 

/usr/1 ocal /apache/bi n/apachectl start 

Arret d'Apache 

Pour arreter le serveur, en tant qu'utilisateur root, saisissez la ligne suivante : 
/usr/local /apache/bi n/apachectl stop 

Integration Zope/Apache 

Pour parfaire notre installation, il reste une etape cruciale : l'instanciation d'un 
objet de type Vi rtual HostMonster. 

II faut installer dans le serveur Zope, a la racine, un objet du type 
Vi rtual HostMonster. LTD de l'objet importe peu. 

C'est cet objet qui va etre responsable de la bonne comprehension des ordres 
passes par Apache. 

Voila ! Nous avons une solide installation de Zope, avec son frontal Apache. 
Cette installation est simple a maintenir, securisee et evolutive. 
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En resume 



Notre site est en production ! Nous avons installe toute la plate-forme depuis un 
systeme d'exploitation fraichement deploye. Nous avons mis en place une 
infrastructure saine sur laquelle nous pouvons capitaliser, par exemple en ajou- 
tant simplement de nouvelles instances, si necessaire. 

Le frontal Apache que nous avons mis en production nous garantit une capacite 
a la montee en charge bien contenue. 

Mais comment nous comporter dans le cas d'un site a tres forte charge ou dans 
le cas d'un site a tres haute disponibilite ? Une seule reponse : ZEO, que nous 
presentons dans le chapitre suivant. 



Montee en charge 
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Votre site intranet et les differents services qu'il fournit sont maintenant fonction- 
nels. La derniere etape du projet consiste a prendre en compte les aspects de la 
gestion des performances et de la montee en charge, et a mettre en ceuvre les 
solutions adequates. 



Objectifs et solutions 



Dans la plupart des cas, pour un site a frequentation moyenne 
(< 20 000 pages/jour), ces conseils ne sont pas utiles. Cependant, et pour 
fournir une solution complete, ce chapitre met en lumiere les solutions tech- 
niques d'amelioration des performances et de capacite a la montee en 
charge. 

Les differentes solutions presentees sont : 

• l'utilisation d'un serveur HTTP specialise comme frontal a Zope : Apa- 
che (http://www.apache.org) ; 

• l'utilisation d'un serveur proxy-cache comme frontal a Zope : Squid 
(http://www.squid-cache.org) ; 

• l'optimisation de la CPU et de la bande passante grace aux gestionnaires 
de cache de Zope (Zope Cache Managers) : RAM Cache Manager, 
HTTP Accelerated Cache Manager ; 

• la mise en ceuvre d'un cluster de serveurs Zope : option Zope Enterprise 
Objects (ZEO). 

Composantes d'un service a hautes 
performances 

Serveur frontal HTTP robuste 

Les principaux serveurs web recommandes sont : 

• Apache ; 

• Microsoft IIS. 

Apache est a ce jour le serveur web le plus utilise 
sur Internet (pres de 60 % de parts de marche). 
Pour surveiller la popularite des serveurs web : 
► http://www.netcraft.com/survey/ ! 



Optimisation des ressources 

Le traitement de certaines requetes HTTP penalise la CPU et la bande pas- 
sante du serveur. On park de requetes ou de traitements « couteux ». Le 
mecanisme d'optimisation consiste a enregistrer les resultats d'une telle 
requete dans une zone de memoire, ou « cache », la premiere fois quelle sur- 
vient, et a servir le contenu a partir de cette zone chaque fois que la meme 
requete est recue. Ainsi, le serveur n'est sollicite qu'une fois pour refaire le 
meme traitement couteux. 



Zope est un serveur d'applications disposant d'un serveur HTTP interne. 
Neanmoins, il est vivement recommande pour les environnements de pro- 
duction de lui adjoindre un serveur HTTP specialise, notamment lorsqu'on 
doit servir un nombre important de pages statiques et/ou d'images a partir 
du systeme de fichiers du serveur. On parle de serveur web proxy. Cette 
approche permet de beneficier des fonctionnalites du serveur web choisi, et 
de laisser Zope simplement jouer son role de serveur d'applications. 
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Le gestionnaire du mecanisme de cache est parametrable pour differents « 
comportements ou besoins : limitation de la taille allouee au cache en J 
memoire vive ou sur disque, types d'objets a prendre en compte, differentes ^ 
strategies d'optimisation, etc. 

Zope fournit deux gestionnaires de cache pour permettre aux concepteurs de 
sites d'ameliorer les performances selon deux strategies d'optimisation 
differentes : 

• RAM Cache Manager pour l'optimisation de la CPU ; 

• HTTP Accelerated Cache Manager pour l'optimisation de la bande pas- 
sante. 



Capacite a la montee en charge 

Pour un site a forte frequentation ou a fort besoin de ressources (CPU, base 
de donnees, calculs, etc.), un seul serveur peut ne pas suffire a absorber la 
charge. Voici les objectifs d'un tel site : 

• Avoir une disponibilite de 99,99 % : le site doit etre disponible au maxi- 
mum. Si une courte panne ou une incapacite survient, c'est genant, mais 
pas vital pour le site ou l'entreprise. 

• Pouvoir accepter un grand nombre de clients simultanes, sans que la qua- 
lite ne se degrade. 

• Supporter des forts pics de charge : le site doit continuer a reagir de facon 
fluide, meme dans le cas de fortes sollicitations passageres, par exemple 
dans le cadre d'un evenement, dans le cas dune publication presse ou 
slashdot, etc. 

Pour ces differents objectifs, outre la solution d'optimisation du code execute 
par les serveurs, la solution de cluster est ideale : chaque machine de la 
grappe va assumer une partie de la charge necessaire. 

Haute disponibilite 

II existe des sites pour lesquels la disponibilite systematique est critique. Par 
exemple, pour des entreprises dont l'activite est a 100 % basee sur un service 
Internet, ou bien dans des metiers ou la disponibilite d'un service est vitale : 
aeronautique, hopitaux, etc. 

Ces sites ont un besoin de 100 % de disponibilite. Les coupures de service ne 
sont pas acceptables dans ce contexte. 

Pour ces besoins, ZEO et la mise en clusters permettent de repartir le risque 
de panne materielle, en multipliant les serveurs d'applications Zope. Le 
risque est divise par le nombre de machines mises a disposition. Bien 
entendu, l'ensemble de la chaine doit etre securise de la meme facon : redon- 
dance electrique, reseau, etc. 
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Recapitulatif 



Presque toutes les solutions presentees peuvent 
cohabitee et elles sont souvent complementaires. 
En effet, on ne peut pas facilement utiliser a la fois 
Squid et Apache : dans 99 % des cas, il faut choisir 
entre ces deux solutions. 
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Les outils du Zopemaster 

1 Les outils de mesures et de tests des performances suivants sont incon- 
tournables pour le webmestre Zope professionnel : 

- Apache Bench est un utilitaire de test fourni avec la distribution 
d'Apache (dans /apache/bin). II permet de tester les performances du 
serveur en specifiant le nombre de requetes a lui envoyer et le nombre 
maximal de connexions simultanees. La syntaxe est du type : 

ab -n 1000 -c 100 http://www.mondomaine.com/news 

- Call Profiler est un utilitaire developpe par Richard Jones (http:// 
www.zope.org/Members/richard/CallProfiler). II permet de connaitre les temps 
d'execution de tous les scripts et methodes intervenant dans une 
requete afin d'aider a reperer d'eventuels scripts couteux. 

2 Les sites de la communaute Open Source vous fournissent les howtos, les 
archives des listes de diffusion, et vous tiennent au courant des nouveau- 
tes vous permettant d'ameliorer votre service ou des bogues existants et 
corriges. Les pointeurs suivants sont done indispensables au webmestre : 

- forum et site communautaire Zope francophone, Zopera : 
http://www.zopera.org ; 

- informations et mises a jour de Zope et CMF : 
http://www.zope.org et http://cmf.zope.org/ ; 

- informations et mises a jour de Plone : http://plone.org ; 

- liste de diffusion du CMF : http://lists.zope.org/mailman/listinfo/zope-cmf ; 

- exemples de codes, astuces et conseils : http://www.zopelabs.com/ et 
http://www.zopezen.org ; 

- O'Reilly Network - Apache DevCenter : http://www.onlamp.com/apache/. 
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Utiliser Apache comme serveur web frontal 
a Zope 

Ajouter un serveur web tel que Apache a l'infrastructure de mise en produc- 
tion d'un site Zope permet de combiner les forces de Zope pour le traite- 
ment de pages dynamiques avec les nombreux avantages d'Apache qui sont : 

• servir du contenu statique (fichiers HTML et images) a partir du sys- 
teme de fichiers ; 

• la gestion de domaines virtuels et la reecriture d'URL ; 

• la prise en charge de SSL (Secure Sockets Layer) pour le commerce electro- 
nique. 

Nous avons vu les details de l'implementation dans le debut de ce chapitre. 



Apache sur MS-Windows 

II est egalement recommande d'utiliser Apache comme serveur web si vous utilisez MS- 
Windows comme plate-forme de production. Vous trouverez toutes les informations sur la 
version d'Apache pour MS-Windows a partir de I'adresse : 

► http://httpd.apache.org/docs/windows.html. 

Les versions multitaches de MS-Windows (NT, 2000, XP) sont a preferer aux versions prece- 
dentes (95, 98, Me). 

Documentation sur Apache 

Quelques pointeurs : 

► http://httpd.apache.org/docs/install.html. 

► http://www.onlamp.eom/pub/a/apache/2000/02/24/installing_apache.html. 



B.A.-BA Apache 



Apache est un logiciel libre qui fournit le service de 
« serveur web ». Un serveur web est responsable 
de la fourniture des pages HTML demandees a un 
client : le navigateur web. 



B.A.-BA SSL 

SSL (Secure Sockets Layer) est un protocole permet- 
tant de securiser les transactions effectuees via 
Internet. II repose sur un procede de cryptographie 
garantissant la securite de la transmission de don- 
nees sur Internet. 

Un serveur securise par SSL possede une URL ou le 
prefixe http:// a ete remplace par https://. 



Utiliser Squid comme serveur proxy-cache 
avec Zope 



Configurer Squid 

Telechargez la derniere version stable de Squid a partir de I'adresse http:// 
www.squid-cache.org, puis procedez a l'installation de l'archive. Selon votre 
configuration specifique (RedHat, Debian ou autre), cette procedure va ins- 
taller tous les fichiers executables et de configuration de Squid dans un 
repertoire du type /usr/local/squid. 

Pour eviter que Squid ne s'execute en tant qu'utilisateur root, ce qui presente 
des risques de securite pour le site, editez le fichier de configuration 



Serveur proxy-cache 



Un serveur proxy-cache permet de decharger les 
serveurs web de la remise de pages frequentes. Ce 
systeme est notamment tres utile pour les images 
qui constituent la charte graphique d'un site : 
celles-ci sont visibles sur toutes les pages du site. 
Avec un proxy-cache, les images ne sont deman- 
dees qu'une seule fois au serveur web, les reque- 
tes suivantes sont directement servies par le proxy- 
cache. 
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Alternatives a Squid 



II est possible, a la place de Squid, d'utiliser le 
module de cache du serveur Apache ou de mettre 
en ceuvre une solution commerciale comme Nets- 
cape Proxy Server ou les produits dedies de Cisco 
Systems. 



squid. conf present dans /usr/local/squid/etc et enlevez le caractere # prece- 
dent les deux lignes suivantes pour les activer : 

cache_effective_user nobody 
cache_effective_group nobody 

Parametrez le cache et les fichiers journaux (logs). Pour definir une taille du 
cache de 100 Mo, modifiez la directive cache_di r du squi d . conf comme suit : 

cache_di r /usr/local/squid/cache 100 16 256 

Bien entendu, il faut adapter la taille du cache a la taille de votre site. II est 
recommande d'utiliser le double de la taille qu'utilise votre site web sur le disque. 
Utilisez les commandes suivantes pour creer le repertoire de cache, nomme 
cache : 

$ cd /usr/local/squid ; mkdir cache 
$ chown -R nobody. nobody cache 
$ cd /us r/local /squid/bin 
$ ./squid -z 

Utilisez les commandes suivantes pour creer le repertoire des journaux, 
nomme logs : 

$ cd /us r/local /squid ; mkdir logs 
$ chown -R nobody. nobody logs 

reinstallation place dans le sous-repertoire /us r/local /squid/bin un script 
Shell nomme RunCache charge de maintenir la fonction de cache active. 
Demarrez Squid a l'aide de la commande : 



Grace a la premiere directive , le serveur 
proxy s'executera sur le port 80, le port stan- 
dard des requetes HTTP. 

La ligne gere le controle d'acces. Par defaut, 
I'acces est interdit a tout le monde via la direc- 
tive http_access deny all. II faut done la 
modifier pour que les autres utilisateurs puis- 
sent y acceder. 

Les lignes Q et Q specifient le nom DNS de la 
machine du serveur a accelerer et le port sur 
lequel ce dernier s'execute. En effet, par concep- 
tion, le serveur Zope fonctionne sur le 
port 8080. 



$ /usr/local/squid/bin/RunCache & 



Plus tard, vous pourrez ajouter cette ligne a votre fichier /etc/rc. local par 
exemple, afin que le serveur Squid soit demarre au boot de la machine. 

Enfin, parametrez Squid en mode d'acceleration HTTP. II s'agit de confi- 
gurer Squid pour qu'il recoive et transfere toutes les requetes HTTP vers un 
port different du port HTTP par defaut (80), sur lequel s'executerait le veri- 
table serveur web. Modifiez les directives suivantes dans le fichier 
squid. conf, apres les avoir « de-commentees » si necessaire : 



http_port 80 
http_access allow all 
httpd_accel_host www . mondomai ne . com 
httpd_accel_port 8080 
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Configuration cote Zope 

Ajouter I'objet de correspondance des domaines 
(VirtualHostMonster) 

Comme pour la configuration avec Apache, I'objet VirtualHostMonster a la 
racine de votre structure Zope est suffisant. 

Utiliser les gestionnaires de cache de Zope 

RAM Cache Manager 

Dans un site Plone, la plupart des pages dynamiques (page d'accueil, index 
internes, pages listant les membres, resultats de recherche, etc.) s'appuient 
sur des requetes vers le moteur d'indexation (l'outil portal_cata"log). Ces 
pages dynamiques peuvent imposer un temps de traitement couteux en utili- 
sation du CPU. II faut done les optimiser et leur appliquer une solution de 
cache. Le gestionnaire de cache specifique appele RAM Cache Manager est jus- 
tement fait pour ce cas de figure. II permet, de maniere transparente, de 
cacher les pages rendues a partir des objets Zope : page templates, methodes 
DTML, scripts Python, en memoire RAM. 

Typiquement, vous allez associer la page d'accueil, dont le contenu est fourni 
par I'objet de type Document nomme index_html, a I'objet RAM Cache 
Manager de Plone. Celui-ci est deja cree a l'installation du site et nomme 
RAMCache. Pour cette configuration, vous pouvez proceder comme suit : 

1 Renommezle document! ndex_html en frontpage, par exemple. 

2 Creez un script Python que vous nommez index_htm"l. Celui-ci va etre 
traite comme l'index lorsqu'on accede a la page d'accueil du site, le but 
etant qu'il renvoie le contenu de frontpage de maniere a pouvoir stocker 
ce contenu en cache. 

3 Finalement, accedez a l'interface de gestion de I'objet RAM Cache Manager 
a la racine du site. L'onglet Associate vous permet de selectionner le type 
script (Python) dans la zone de selection des types d'objets a associer au 
gestionnaire. Lorsque vous cliquez sur le bouton Locate, l'interface vous 
affiche la liste des scripts Python que vous pouvez associer au gestion- 
naire. II ne vous reste plus qua selectionner I'objet indexjitml, et a cli- 
quer sur le bouton Save Changes. 

4 Vbtre nouvelle page d'accueil est maintenant prise en compte par le ges- 
tionnaire de cache en RAM de Zope. Vous pourrez vous rendre compte 
du gain de temps de chargement lorsqu'on charge la page, et ce des la 
seconde fois. 



Figure 9-1 
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Vous pouvez appliquer la mime strategie aux autres pages du mime type, 
telles que la page d'affichage de la liste des membres du site (egalement 
nomme « roster »). 



Mise en garde 



La mise en ceuvre du cache Zope doit etre faite de 
maniere reflechie. II ne faut pas avoir a mettre trop 
de choses dans le cache, seuls les objets qui chan- 
gent peu sont conseilles, sinon vous vous retrouve- 
rez avec le meme probleme parce que le gestion- 
naire de cache, a son tour, consommera trop de 
ressources. 



HTTP Accelerated Cache Manager 

Au sein de votre site, vous pouvez egalement avoir un nombre important 
d'images telles que les photos des membres du site, affiches dans la page 
roster de Plone, ou qu'une galerie d'images. Le chargement de ces images 
est couteux en bande passante, d'autant plus que ce sont des elements stati- 
ques, Zope mettra systematiquement en branle sa machinerie pour traiter les 
requetes d'affichage des images, alors que leur frequence de changement est 
rare. Encore un fois, Zope est optimise pour le traitement de pages dynami- 
ques, et non statiques. 

L'autre gestionnaire de cache de Zope, HTTP Accelerated Cache Manager, 
permet de resoudre cette problematique. 

De la meme maniere que pour le RAM Cache Manager, il suffit d'aller sur 
l'objet HTTP Accelerated Cache Manager a la racine du site Plone, puis de lui 
associer tous les objets Image du site a prendre en compte (onglet Associate). 



B.A.-BA Zope Enterprise Objects 



ZEO (Zope Entreprise Object) est la solution fournie 
avec Zope qui permet de construire tres simple- 
ment des clusters de serveurs Zope, pour augmen- 
ter la disponibilite ou la capacite a la montee en 
charge d'un site Zope. 



Haute disponibilite et montee en charge 
avec ZEO 

Le besoin de faire un cluster de serveurs Zope peut surgir dans deux cas de 
figures principaux : 

• pour des « gros » sites (montee en charge) ; 

• pour des sites « critiques » (haute disponibilite). 

Dans ces deux cas, on remarque que la solution est bien de multiplier les ser- 
veurs, et done de disposer d'une solution de clustering. 
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Difficultes de mise en oeuvre 



Multiplier les serveurs web est une tache aisee pour des sites statiques (pages 
HTML sur disque, servies par Apache par exemple) : il suffit de copier les 
fichiers statiques sur toutes les machines, et de demarrer les serveurs web. 

Pour un site dynamique, la tache est plus complexe : 

• tous les serveurs doivent avoir les memes donnees ; 

• si un serveur modifie un objet , il faut notifier les autres. 

On est bien face a i'epineux probleme de la synchronisation des donnees de 
plusieurs serveurs. 

La solution ZEO 

ZEO est done la solution pour resoudre ces differentes problematiques avec 
Zope. 

Fonctionnalites de ZEO 

ZEO permet done de faire des clusters Zope. Les fonctionnalites et avan- 
tages de cette solution sont les suivants : 

• Haute disponibilite : si un des serveurs du cluster cesse de fonctionner, le 
site fonctionne toujours. 

• Montee en charge : en divisant la charge par le nombre de serveurs, le 
site est capable d'accepter plus de clients simultanes et ainsi de faire face 
a la montee en charge. 

• Distribution de la charge : avec plusieurs serveurs, et si la repartition de 
charge est concue intelligemment, la repartition de l'activite des diffe- 
rents serveurs permet une plus forte reactivite du site. 

• Mise a disposition de ressources temporaires : en cas d'evenement previ- 
sible (publication presse, evenementiel, elections) ou pour faire face a une 
montee en charge brutale, il « suffit » d'ajouter des machines au cluster 
pour voir la disponibilite globale du site augmenter. Ces serveurs peuvent 
ensuite etre supprimes apres le passage du pic. 

• Distribution des serveurs : en multipliant le nombre de machines, on a 
une diminution du risque « physique » pour les serveurs, et done une 
augmentation de la disponibilite theorique. La probabilite que toutes les 
machines tombent en panne en meme temps diminue fortement si on 
augmente le nombre de machines ! 

• Integrite transactionnelle : il existe des regies permettant de regler les 
problemes de mise a jour simultanee de l'information par deux serveurs 
concurrents. 



Fonctionnement de ZEO 



Comparaison entre I'architecture Zope standard et I'architecture ZEO 
Schema du cas « Zope Standard » Q 
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Le processus serveur Zope est « proprietaire » de la base de don- 
nees objet ZODB. 

Schema du cas « Zope avec ZEO » © 

La base objet ZODB est portee par un serveur dedie, appele Serveur 
ZEO. Ce serveur est utilise par les clients ZEO, qui forment le serveur 
d'applications. 




Serveur 
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ZODB 





Supposons qu'on dispose de N machines a mettre en cluster. Ces serveurs 
seront utilises de la facon suivante : 

• 1 serveur de stockage : ZEO Server, contenant la ZODB ; 

• N-l clients ZEO. Ces machines se comportent comme des serveurs 
Zope standards. Ce sont ces machines qui servent les pages web. 

On le voit, seule une machine est proprietaire de la base objet ZODB qui 
contient toutes les donnees. Toutes les autres instances Zope sont des clients 
ZEO, qui viennent chercher aupres du serveur ZEO les informations dont 
elles ont besoin. Grace au systeme de cache de Zope, les conversations entre 
les clients et le serveur sont reduites au strict necessaire. 



Mise en ceuvre 



Prerequis 

Pour installer notre cluster, nous devons disposer de N machines. Si possible, 
et pour plus d'homogeneite, ces N machines utiliseront le meme systeme 
d'exploitation, mais ce n'est absolument pas obligatoire. L'utilisation de 
machines Unix est fortement recommandee, meme si ZEO fonctionne ega- 
lement sous MS-Windows. 
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Schemas d'architecture 

Un utilisateur se connecte a un serveur web 




II 



Ce serveur web est en fait un cluster Zope/ZEO 
Voici le detail des echanges : en fait, la seule machine que I'utilisa- 
teur « voit » est la machine chargee de la distribution de la charge. 
Nous verrons plus loin les details de son implementation. Cette 
machine se charge de designer le client ZEO qui va servir la page 
demandee par le client. Une des machines du cluster se charge 
done du calcul de la page demandee, en se referant si necessaire 
(ou dans son propre cache) aux donnees disponibles sur la machine 
serveur ZEO. Ainsi, la disponibilite est bien amelioree, et la charge 
que le systeme peut supporter est bien augmentee. 




Client 



Distribution 
de charge 



Clients ZEO 



Serveur ZEO 



Sur ces N machines, Zope sera installe dans un repertoire que nous noterons 
SZOPE. 

II faut installer strictement la meme version de Zope sur ces differentes 
machines. ZEO ne verifie pas ce point, et un non-respect de cette regie peut 
amener a des pertes de donnees massives. 

Egalement, les memes produits Zope doivent etre installes sur ces 
N machines. 

Enfin, toutes les machines doivent avoir un acces identique aux ressources 
necessaires a 1' application : bases SQL, serveur mail, etc. 

Le fichier Data.fs (image de la base ZODB) ne sera installe que sur la 
machine serveur ZEO. Les N-l machines ZEO clientes n'ont pas de fichier 
Data.fs. 



135 



Installation 



La derniere version de ZEO est maintenant livree avec Zope, depuis la 
version 2.7. II convient done de suivre la documentation d'installation du 
chapitre precedent, pour tous les serveurs physiques. Seule l'installation du 
ZEO Server est un petit peu differente. 



Demarrage ZEO Server 

L'installation de ZEO Server se fait au moment de la creation de l'instance 
Zope. Nous allons en creer une specialement concue pour etre ce serveur. 

En tant qu'utilisateur Zope, sur le serveur qui va etre ZEO Server, entrez les 
commandes suivantes : 

zope$ cd 

zope$ mkdir instances 

zope$ Zope2.7/bin/mkzeoinstance.py --di r=instances/zeoserver 8070 

Pour demarrer le serveur, on utilise simplement (en tant qu'utilisateur zope) : 
zope$ cd 

zope$ instances/zeoserver/bin/zopecti start 

Cette commande va demarrer le serveur ZEO, qui va attendre ses ordres sur 
le port 8070 de la machine serveur. 



Demarrage ZEO client 

Sur les machines clientes, la seule difference dans l'installation concerne le 
fichier etc/zope . conf , dans lequel il faut enlever la partie : 

<zodb_db main> 

# Main FiieStorage database 
<fiiestorage> 

path /home/zope/instances/plonel/var/Data.fs 

</fi iestorage> 

mount-point / 
</zodb_db> 
<zodb_db temporary> 

# Temporary storage database (for sessions) 
<temporarystorage> 

name temporary storage for sessioning 
</temporarystorage> 
mount-point /temp_folder 

contai ner-ci ass Products .Temporary Foi der .TemporaryContai ner 
</zodb_db> 
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pour la remplacer par : 

<zodb_db main> 
mount-point / 
<zeoclient> 

server zeoserverhostname:8070 

storage 1 

name zeostorage 

var /home/zope/i nstances/plonel/var 
</zeoclient> 
</zodb_db> 

Enfin, le demarrage du (des) client(s) ZEO (et done du serveur d' applica- 
tions Zope), se fait « normalement » avec : 

| zope$ instances/plonel/bin/zopectl start 

Voila ! Vos clients ZEO communiquent avec votre serveur ZEO, de maniere 
transparente. Un seul serveur est responsable du stockage, et N-l machines 
sont disponibles pour calculer le rendu des pages. 

Connexion a un client 

Si on se connecte avec un navigateur a l'un des clients ZEO (qui est done 
l'un de nos N-l serveurs Zope maintenant), on constate que son Control 
Panel a un petit peu change, notamment la rubrique DataBase. 

En effet, on note que la machine qui porte la base ZODB et le numero de 
port sont specifies : on est bien connecte a un serveur ZEO. 

Le cas des serveurs multiprocesseurs 

Si une des machines ZEO clientes est un serveur multiprocesseur, il est for- 
tement conseille de demarrer autant de processus clients que de CPU dans la 
machine. En effet, Python possede un lock global au processus, ce qui fait 
que Zope n'utilise pas pleinement les capacites d'un tel serveur. En utilisant 
N clients ZEO sur cette machine, on a la certitude que chaque CPU fera 
tourner une instance de Zope pleinement. 

Limites et dangers de ZEO 

La programmation d'un serveur avec ZEO impose tout de meme quelques 
precautions... 

Limites (('utilisation 

En respect du modele web, ZEO est tres efficace si le site respecte le ratio 
90/10 : 90 % de lecture d'information pour 10 % d'ecriture. Au-dela, si le 
site doit ecrire plus d'informations dans la ZODB, on penalise le systeme en 



B.A. BA Sessions 

Dans le contexte des sites web dynamiques, une 
session permet de transporter des informations 
liees a un internaute pendant la duree de sa navi- 
gation sur le site. Une session se definit done par 
un identifiant unique, une duree de vie, et un 
ensemble de variables contenant les informations 
qu'elle transporte. 



ATTENTION Securite 

Le serveur ZEO n'est en rien securise. Le port 
qu'il ouvre sur la base ZODB n'est valide par 
aucune regie de securite. Si, par malheur, un 
pirate venait a connecter un client ZEO sur votre 
serveur ZEO, il pourrait en faire ce que bon lui 
semble. 

Pour eviter des desagrements majeurs, il faut 
utiliser la securite de votre reseau, par exemple 
avec un pare-feu en amont. Une solution habi- 
tuelle est de laisser le repartiteur de charge dans 
la partie publique du reseau (ou dans la DMZ), 
et de placer les W-1 clients ZEO dans un partie 
protegee, sur une classe d'adresses non routa- 
bles (sur un reseau local). 



B.A.-BA Securite 

Pare-feu ou firewall. Systeme informatique per- 
mettant de proteger un reseau local d'entreprise 
des agressions provenant d'lnternet. 
DMZ (De-Militarized Zone). Reseau ajoute entre le 
reseau interne (protege) et Internet, la DMZ fournit 
une couche de securite supplemental. 



augmentant le nombre de confiits d'acces concurrents. Dans ce cas, stacker 
plus de donnees dans une base SQL supportant bien les ecritures multiples 
et concurrentes est une solution. 

Dangers applicatifs 

L'essentiel des dangers applicatifs se resume simplement : etant donne que 
deux requetes consecutives de l'utilisateur n'utilisent par forcement le meme 
serveur, il faut faire attention aux variables qui ne sont valables que dans le 
cadre d'un serveur. 

Sessions 

Un bon exemple de situation a risque est l'utilisation de sessions en RAM 
(cas du composant de session livre avec Zope). En effet, imaginons qu'une 
machine Zl traite la premiere requete client et stocke des informations dans 
une session en RAM. Si la seconde requete du client est traitee par une 
machine Z2, alors celle-ci n'aura pas en RAM les informations necessaires. 
Une facon simple de resoudre ce probleme est d'utiliser un composant de 
gestion des sessions dans une base SQL commune par exemple. 

Temporary Folder 

Comme pour les sessions, le composant temp_f older fourni avec Zope 
stocke ses informations dans la RAM du serveur qu'il execute. Pour les 
memes raisons, son usage est deconseille avec ZEO. 

Fichiers sur disque 

Un autre cas de danger pour l'application est de faire des manipulations de 
fichiers sur le serveur d'applications. En effet, a moins d'utiliser un systeme 
de fichiers distribue ou partage (NFS par exemple), on ne retrouvera pas les 
memes fichiers d'une machine serveur a l'autre. 

Ce point est problematique dans le cas d'utilisation de la base de donnees 
GadFly, et plus generalement des composants Zope qui stockent leurs infor- 
mations sur le disque du serveur (souvent dans le repertoire $Z0PE/var). 

Pour pallier ce probleme, il faut soit utiliser un systeme de disque partage, 
comme NFS sous Unix, soit trouver des composants qui n'utilisent pas ce 
principe. 

Distribution de charge 

II est temps d'aborder les differentes solutions qui permettent de faire la 
repartition de la charge. 

II existe differentes reponses usuelles, plus ou moins simples a mettre en 
oeuvre, et plus ou moins heureuses. 
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Choix du miroir par 1'utilisateur 

C'est la solution la moins chere : elle consiste a proposer a 1'utilisateur de cli- 
quer sur l'URL du client ZEO sur la page d'accueil. Cette solution est tres 
limitee et n'apporte pas vraiment de reponse satisfaisante, mais elle permet 
de faire les premiers tests. 

DNS Round Robin 

Cette solution est assez courante, notamment pour les sites statiques. Elle 
consiste a placer la repartition de la charge au niveau du DNS. Ainsi, lorsque 
les utilisateurs demandent pour la premiere fois a voir la page www.mondo- 
maine.com, le DNS va leur donner l'adresse IP de l'un des clients ZEO, direc- 
tement. Les adresses distributes par le serveur DNS sont equireparties (dis- 
tribution sequentielle). Cette solution est tres simple, mais presente deux 
inconvenients majeurs. 

• La repartition n'est pas une repartition de charge. Si la machine designee 
par le DNS est deja chargee par d'autres utilisateurs intensifs, la qualite 
du service rendu se degrade. 

• Et surtout, si la machine serveur tombe en panne, 1'utilisateur ne pourra 
plus se connecter, son ordinateur ayant mis en cache l'adresse IP du client 
ZEO pour plusieurs heures. 

Pour mettre en oeuvre cette solution, il suffit d'utiliser un fichier DNS de la 
forme : 

www 300 IN A 10.0.0.1 
300 IN A 10.0.0.2 
300 IN A 10.0.0.3 
300 IN A 10.0.0.4 

Ainsi, TIP demandee pour la machine www sera tour a tour 10.0.0.1, 
10.0.0.2, 10.0.0.3 puis 10.0.0.4, suivant l'ordre de requetes des differents 
clients. 

Serveur proxy web 

Un serveur proxy est un service qui recoit des requetes web de clients, les 
passent a une tierce machine, pour retourner la reponse au client. C'est ce 
que fait Apache lorsqu'il est installe en frontal de Zope de maniere classique. 

C'est ce meme principe, un peu elabore, qui va nous servir pour realiser un 
systeme de repartition de charge a la fois simple et economique. 

Notre systeme est base sur Apache, qui va recevoir les requetes des clients, et 
se charger de les transmettre a l'un des N-l clients ZEO. 



B.A.-BA DNS 

DNS (Domain Name System) est un service fonda- 
mental des reseaux TCP/IP en general, et d'lnter- 
net en particulier. C'est le service qui est responsa- 
ble de la correspondance entre le nom de la 
machine (ex. : www.zopera.org) et l'adresse IP 
unique qui identifie la machine sur le reseau. Pour 
le service inverse, on parle de reverse-DNS. 
Le serveur DNS le plus utilise d'lnternet est un logi- 
ciel libre nomme BIND. 
► http://www.isc.org/products/BIND/ 
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Pour ce faire, il faut commencer par ajouter le fichier Balance. py, dans le 
repertoire /usr/local/bin par exemple : 

#!/usr/bin/env python 
import sys, string 
count=0 

SERVERS=['wwwl' , 'www2' , 'www3'] 
NB_SERVERS=1 en (SERVERS) 

URL="http : / /%s . mondomai ne . com : 8080/Vi rtual HostBase/http/www . 
mondomai ne . com : 80/%s" 
def trans! ate(data) : 
global count 

count=(count+l) % NB„SERVERS 

return URL % ( SERVERS [count] , data ) 

if name ==" main ": 

data=stri ng . stri p(sys . stdi n . readl i ne () ) 
if not data: 
break 

sys . stdout . append(data) 
sys.stdout.flushO 

Ce petit programme se contente de transformer les chemins qu'il recoit en 
entree (via stdin) en une URL sur un des serveurs Zope (un des N-l clients 
ZEO). II retourne le resultat sur stdout. 

Exemple : 

/about => http ://wwwl. mondomai ne.com: 8080/Vi rtualHostBase/http/ 

*»www. mondomaine.com:80/about 
/servi ces/regi ster=>http : //www2 . mondomai ne . com : 8080/Vi rtual HostBase/ 

*»http/www. mondomai ne . com : 80/servi ces/regi ster 

On remarque que les clients sollicites sont alternativement wwwl, puis www2, 
puis www3 et que le chemin est bien ajoute dans l'URL qui nous interesse. 

Le format de l'URL est le meme que le format utilise pour la programma- 
tion de vi rtual host Zope avec Apache, et pour cause ! 

Enfin, ce programme est donne a Apache, au travers de la modification sui- 
vante de httpd.conf : 

<Vi rtual Host www.mondomaine.com> 

ServerAdmi n webmaster@mondomai ne . com 
ServerName www.mondomaine.com 
ErrorLog /var/log/www.error_log 
CustomLog /var/log/www.access_log 
RewriteEngine On 

RewriteMap balance prg:/usr/local/bin/balance.py 
RewriteRule A/(.*)$ ${balance:$l} [P,L] 
</Vi rtual Host> 

On remarque que la regie de correspondance dApache est deleguee a notre 
petit programme bal ance . py. 



Ainsi, les utilisateurs du site ne voient qu'un seul serveur web, qui est un ser- 
veur Apache, lequel sous-traite toutes ses requetes aux N-l clients ZEO. 

Routeur « Soft » 

On peut utiliser assez simplement des solutions a base de logiciels libres 
comme IPNAT, VRRPD, ou Linux VirtualServer pour remplir cette tache. 

Les details d'implementation depassent largement notre cadre. 
Routeur « Hard » 

II est possible d'utiliser des commutateurs de niveau 4 pour effectuer les 
taches de resilience (haute disponibilite) et de repartition de charge. 

Les equipements du marche les plus souvent mis en place sont les modeles 
Alteon et LocalDirector de Cisco Systems. 



POUR EN SAVOIR PLUS 

Pour creuser le domaine des clusters Linux, on 
recommande la lecture de : 

► http://www.linuxvirtualserver.org/ 

VRRPD pour FreeBSD est detail le sur I'excellent 
site : 

► http://www.bsdshell.net/hut_fvrrpd.html 



En resume... 

Apres l'application des differentes mesures presentees dans ce chapitre, nous 
disposons maintenant d'un site intranet particulierement robuste, permet- 
tant d'offrir un service de qualite aux utilisateurs, ce qui est fondamental 
pour obtenir une bonne implication de leur part sur ce type de projet. 
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Annexes 



Zope Pages Templates 
L'API de Plone 
Aide-memoire Archetypes 



Zope Pages Templates 





Attribut | template | expression | espace de nommage | macro 



<html-xmlns="http: / /mm. w3. org/1999/xhtml" -xml: lang="en" • lang="en" 

metal: use-macrQ="here/main_template/macros/master" 

il8n: domain="plone"> 

<body> 

<metal:main- f ill-slot=' r main"> 

<tal : main-macro- me tal : de£ine-macro="main" • tal: de£ine=' r len_text- python: len (here, text) ;"> 

<hl- tal: content="here/title_or_id"*class="documentFirstHeading' r > 

Title-or-id 

</hl> 

<div- metal :use-macro="here/document_actions/macros/document_actions''> 

Document- actions- (print, ■ sendto- etc) 

</div> 

<div- class="documentDescription" 

tal : content="here/Description"> 

description 

</div> 

<div class="stx" 

tal: condition="len_text" 

tal: attributes="class- python: test (here. text_format== ' structured- text' , ■ 1 stx ' , ■ 'plain' ) "> 

<div tal: replace="3truc ture -python: here. CookedBodY(sD(_level=2) "■ /> 

</div> 

<div- metal :use-macro="here/document_byline/macros/byline"- /> 

• ■ • '</tal:main-macro> 
</metal:main> 

</body> 



ZPT est un mecanisme fournissant un objet template, et qui s'appuie sur trois 
langages : 

• TAL (Template Attribute Language) ; 

• TALES (TAL Expression Syntax) ; 

• METAL (Macro Expansion Template Attribute Language). 

TAL specifie les operations possibles, TALES le langage d'expression dans lequel les 
ordres sont exprimes et METAL est le systeme de macro de ZPT. 



TAL 



Syntaxe generale d'une operation TAL 

<balise tal:commande="expression"> ... </ 
balise> 



La grammaire de TAL est tres simple : quelques « mots » seulement sont dispo- 
nibles dans le vocabulaire de TAL. Chaque mot represente en fait le type de 
transformation portee par l'attribut tal : remplacement du contenu de la balise, 
de la balise elle-meme, manipulation de ses attributs, etc. D'autres operations, 
plus propres a un langage procedural sont egalement disponibles : boucles, con- 
ditions, definition de variables. 
TAL propose done les operations suivantes : 

• content - pour remplacer le contenu d'une balise ; 

• repl ace - pour remplacer toute la balise ; 

• attri butes - pour manipuler les attributs de la balise ; 

• def i ne - pour definir une nouvelle variable ; 

• repeat- pour faire une boucle ; 

• omi t-tag - pour ne pas produire la balise elle-meme ; 

• on-error - pour definir le comportement en cas d'erreur. 

Premiers pas avec TALES 

Une expression TALES permet de manipuler les objets de Zope, par exemple 
pour retrouver le titre de la page en cours : 

here/title 

Dans une expression TALES simple, la barre oblique « / » est l'equivalent du 
« . » dans les langages objets (dont Python). 

Le prefixe here signifie « le sommet de la pile d'acquisition ». En d'autres 
termes, on demande a TALES de retrouver la propriete title dans le contexte 
courant. C'est exactement la meme chose que d'ecrire context. title dans un 
script Python. 

Une deuxieme ecriture nous sera necessaire pour bien comprendre les exemples 
qui vont suivre : 

request/URL 

Cette expression permet de retrouver la variable URL portee par le celebre objet 
REQUEST de Zope. 
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Les operations TAL 
Operation « content » 

L'operation content permet de remplacer le contenu de la balise par le contenu 
produit par l'expression passee en parametre. Void un exemple : 

<hl tal :content="here/title">Mon titre</hl> 

Dans ce cas, le contenu de la balise HI, ecrit par la personne qui a 
fait la maquette graphique, est remplace dynamiquement a 1 'execution 
par le titre de la page en cours : 
<hl>Le CMS Plone</hl> 

Contrairement au DTML, le texte produit est automatiquement converti au 
format HTML. Cela signifie que tous les contenus manipules sont systemati- 
quement transformes pour garantir un affichage fidele dans le navigateur. Tech- 
niquement, cela signifie que le contenu est transforme par la fonction 
html_quote avant la substitution. C'est une des differences avec DTML : cette 
operation devait etre explicite en DTML, avec l'ajout du mot-cle html_quote a 
la balise dtml-var. 

Pour ne pas subir cette transformation, le prefixe structure doit etre employe : 

<div tal :content="structure here/maTable"> 
Ici le rendu de la table, avec ses balises 
</div> 

Dans ce cas, le code HTML de l'expression n'est pas modifie. Cette instruction 
est done equivalente, en DTML, a <dtml-var maTablex 

Operation « replace » 

L'operation replace permet de remplacer l'element complet (balise et contenu) 
par le contenu produit par l'expression passee en parametre. Void un exemple : 

<p>Le titre de ce livre est <b tal : replace="here/title">Le titre</b> 
</p> 

En lisant trop rapidement ce code, on peut penser que la production sera : 
<p>Le titre de ce livre est <b>Zope, 2eme edition</bx/p> 

C'est le comportement qui est obtenu par l'operation content, mais l'operation 
replace produit bien : 

| <p>Le titre de ce livre est Zope, 2eme edition</p> 

On remarque que la balise porteuse de l'operation TAL a disparu. L'operation 
replace peut done etre utilisee lorsqu'un formatage prevu par le concepteur gra- 
phique pour mettre en evidence une portion de la page n'est pas necessaire dans 
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SYNTAXE 

tal:content= 

"[structure] Expression TALES" 



SYNTAXE 

tal:replace= 

"[structure] Expression TALES" 



le rendu final. Nous verrons plus loin d'autres cas d'utilisation de l'operation 
replace. 



SYNTAXE 



tal:attributes= 

"ExpressionTALESI , 

ExpressionTALES2; 

ExpressionTALES3; 



Operation « attributes » 

L'operation attributes permet de remplacer et/ou de modifier les valeurs des 
attributs de la balise. Voici un exemple : 

<img src="logo.gif " 

tal :attributes="src here/getLogoImageURL; border string:l"/> 

Cet exemple vient renseigner dynamiquement l'attribut src de la balise img pour 
specifier l'emplacement de l'image a charger. On peut imaginer que 
getLogoImageURL est un script Python qui fournit l'adresse d'une image en fonc- 
tion des parametres du contexte (par exemple, la langue du navigateur de l'utili- 
sateur). 

Dans l'exemple, deux attributs sont renseignes : src avec l'URL de l'image et 
border, qui portera toujours la valeur 1. 
La production obtenue est, par exemple : 

<img src="i mages/1 ogos/f rancais.gif" border="l"/> 



SYNTAXE 



tal:define= 

"[global] NomVariable 
ExpressionTALESI; [global] 
NomVariable ExpressionTALES2; 
[global] NomVariable 
ExpressionTALES3; ..." 



Operation « define » 

L'operation def i ne permet de creer et de renseigner des variables temporaires 
dans la Page Template en cours. La portee d'une variable ainsi definie peut etre : 

• Locale : la variable est visible depuis la balise qui porte l'attribut tal : def i ne, 
mais aussi pour toutes les balises quelle contient. 

• Globale : la variable peut etre visible pour tous les objets que la Page 
Template utilisee manipule. Cela signifie que non seulement la balise qui 
porte l'attribut tal : define et les balises contenues voient la variable, mais 
aussi les balises situees en dehors du bloc concerne et egalement les Page 
Templates et autres objets Zope utilises dans le rendu de la page en cours. 
Bien entendu, la variable n'est visible que pour les objets evalues apres la 
declaration de la variable. 

La portee par defaut est locale. Pour preciser une portee globale, il faut prefixer 
l'expression du mot-cle global . Prenons un exemple : 

<p tal :define="utilisateur request/AUTHENTICATED_USER"> 

Bienvenue <b tal :content="utilisateur">Nom de 1 'utilisateur</b> ! 

</p> 

La variable utilisateur est definie dans toute la portee de la balise p. La 
variable est tres simplement utilisee dans l'operation tal : content de la ligne qui 
salue l'utilisateur. 
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La production obtenue est : 



<p>Bienvenue <b>userl</bx/p> 

Operation « repeat » 

Loperation repeat permet d'effectuer des boucles ou des iterations dans le cadre 

SYNTAXE 

d'une template. C'est une operation notamment tres utile pour construire des 

tableaux, ou les lignes sont la repetition du meme modele. Ainsi : tal:repeat= 

"NomVariable ExpressionTALES" 

<table border="l"> 

<tr tal : repeat="fichier here/objectValues"> 

<td tal :content="fichier/id">Nom du fichier</td> 
<td tal :content="fichier/title">Titre du fichier</td> 
</tr> 
</table> 

Cet exemple permet d'afficher la liste des fichiers presents dans le repertoire 
courant, en precisant leur identifiant et leur titre. 

On remarque que le gabarit qui est reproduit est celui porte par la balise tr : il y 
aura dans la production autant de balises <tr>...</tr> que de fichiers presents 
dans le repertoire courant. 
La production attendue est : 

<table border="l"> 
<tr> 

<td>mon_cv . doc</td> 

<td>Mon CV</td> 
</tr> 
<tr> 

<td>comptes_janvi er . xl s</td> 
<td>Comptes de ]anvier</td> 
</tr> 
<tr> 

<td>ludo. jpg</td> 
<td>Photo de Ludo</td> 
</tr> 
</table> 

Iterations imbriquees 

II est possible d'utiliser des operations imbriquees. Par exemple, le code suivant 
permet d'afficher une table de multiplication : 

<table border="l" tal :define="liste python: [1,2, 3,4, 5,6, 7,8,9, 10]"> 

<tr tal : repeat="x liste"> 

<td tal : repeat="y 1 iste"tal :content="python:x*y">X * Y</td> 

</tr> 
</table> 
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Loperation def i ne portee par la table permet de construire une variable qui est 
une liste Python contenant les valeurs entieres de 1 a 10. 

Le tr porte une premiere iteration, avec x qui prend pour valeurs successives les 
valeurs de la liste. 

Enfin, le td est repete a nouveau pour tous les elements de la liste, mais sur la 
variable d'iteration y. On note que le resultat est obtenu par une operation 
content, qui utilise la formule x*y exprimee en Python. 

Informations portees par les iterations 

Pour acceder a des informations relatives a l'iteration elle-meme, une variable 

particuliere, repeat, est accessible au sein des expressions TALES. 

La variable repeat contient une entree par boucle en cours (c'est-a-dire qu'il est 

possible d'acceder a des boucles imbriquees). 

Voici un exemple d'utilisation : 

<table border="l"> 

<tr tal : repeat="i tern here/objectVal ues"> 

<th tal :content="repeat/item/number">No de fichier</th> 
<td tal :content="item/tit1e_or_id">Titre du fichier</td> 
</tr> 
</table> 

Cet exemple va creer un magnifique tableau avec la liste des objets contenus 
dans le dossier courant. On retrouve le numero d'ordre de l'objet dans la pre- 
miere colonne (avec repeat/i tern/number), suivi du titre de l'objet dans la 
seconde. 

Les variables d'iterations portent les informations suivantes : 

• i ndex - l'index de la repetition dans la sequence en cours (commence a partir 
de zero) ; 

• number - comme i ndex, mais commence a partir de 1 ; 

• even - retourne la valeur « vrai » si l'index en cours est pair (0, 2, 4, etc.) ; 

• odd - retourne la valeur « vrai » si l'index en cours est impair (1, 3, 5, etc.) ; 

• start - retourne la valeur « vrai » pour la premiere iteration ; 

• end - retourne la valeur « vrai » pour la derniere iteration ; 

• f i rst - retourne la valeur « vrai » pour la premiere iteration d'un groupe ; 

• 1 ast - retourne la valeur « vrai » pour la derniere iteration d'un groupe ; 

• 1 ength - nombre total d'iterations ; 

• letter - comme index, mais exprime avec des lettres : a-z, aa-az, ba-bz, 
za-zz, aaa-aaz, etc. ; 

• Letter - comme 1 etter, en majuscules ; 

• roman - comme i tern, en lettres romaines minuscules : i , i i , i i i , i v, v, etc. ; 

• Roman - comme roman, en majuscules. 



Operation « on-error » 

L'operation on-error est appelee si la balise en cours leve une exception dans le 
traitement d'une operation TAL. Dans ce cas, l'exception est etouffee et la pro- 
duction utilisee est celle de l'expression TALES portee par la commande on- 
error. 

L'objet exception est ajoute au namespace dans la variable error. Vbici un 
exemple : 

<p>Le prix de 1 'article est <b tal :content="here/prix" 
tal :on-error="string:N/A">0.00</b> Euros. </p> 

Cet exemple affiche le prix d'un produit. Admettons que le prix soit une pro- 
priete prix, portee par les objets concernes. Dans le cas ou l'objet n'a pas cette 
propriete (parce que l'administrateur a oublie de la saisir par exemple), la chaine 
N/A est affichee a la place du prix. 



SYNTAXE 



tal:on-error= " ExpressionTALES" 



Operation « omit-tag » 

L'operation omit-tag est utilisee pour ne pas produire la balise qui la porte, mais 

seulement son contenu. Ceci permet d'utiliser des balises pour porter de la 

logique, sans que celles-ci ne soient produites par le moteur de rendu. tal:omit-tag=" " 

Associer tal: content a tal: omit-tag 

<p>0n compte de 1 a 3 : equivaut a utiliser une operation 

<span tal : repeat="cpt python:range(l,3)" tal : content="cpt">l</span> tal:replace. 

</p> 

Ce code produit : 

<p>0n compte de 1 a 3 : 

<span>l</span> 

<span>2</span> 

<span>3</span> 
</p> 

Si on utilise tag-omit : 

<p>0n compte de 1 a 3 : 

<span tal : repeat="cpt python:range(l,3)" tal : content="cpt" tal:tag- 
omit="">l</span> 
</p> 

Le resultat est le suivant : 

<p>0n compte de 1 a 3 : 
1 
2 
3 

</p> 

La balise porteuse span n'a pas ete produite. 
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Operations multiples 

Toutes les commandes peuvent etre utilisees en combinaison dans le cadre de la 
meme balise, comme dans l'exemple suivant : 

<p tal :content="here/myContent" 

tal :attributes="align string: 'center'">l_e contenu i ci </p> 

Dans cet exemple, la methode Python myContent est appelee pour fournir le 
contenu du paragraphe, et 1'attribut align est positionne a center. 
La seule combinaison interdite est le melange des operations content et 
replace, qui sont mutuellement exclusives. 

Cependant, une meme commande ne peut apparaitre qu'une seule fois dans le 
corps dune balise. 

Si plusieurs commandes TAL sont disposees sur une meme balise, l'ordre de 
priorite dans lequel elle sont evaluees est le suivant : 

• define; 

• condition; 

• repeat ; 

• content ou replace ; 

• attributes; 

• omit-tag. 

TALES 

TALES est le langage dans lequel sont ecrites les expressions TAL portees par 
les attributs, par exemple : 

<i tal :content=" ExpressionTal">b~\a bla</i> 

Une expression TALES est generalement formatee de la facon suivante : 
| prefixe:expression 

oil prefixe permet de preciser le type de l'expression. 

Lexpression est interpretee grace au type precise. Le prefixe peut etre omis. 
Dans ce cas, c'est le type par defaut (path) qui est utilise. 
TALES propose principalement les types d'expression suivants : 

• path, 

• not, 

• string, 

• nocall, 

• exists, 

• python. 



Expressions de type « path » 

Elles permettent d'inserer ou de remplacer la valeur d'un objet ou attribut dis- 
ponible dans la pile d'acquisition de la template. Ce sont les expressions simples 
qui ont ete le plus utilisees jusqu'ici (dans les exemples) et ou Ton se sert de la 
barre oblique « / » a la place de la notation « . » usuelle des langages tels que 
Python. Le prefixe utilise est path, mais il est generalement omis. 
TALES fournit plusieurs variables implicites telles que here et request, qui faci- 
litent l'ecriture des expressions. Les variables implicites sont presentees en detail 
plus loin. 

Voici quelques exemples simples avec ce type d'expression : 

<div tal :define="fichiers container/dossier/objectValues" > 
<div tal : repeat="fichier fichiers" 

tal :content="fichier/title_or_id" > 
Fichier 
</div> 
</div> 

<span tal :content="user/getUserName" > jdupont </span> 
Date de modification : 

<span tal : replace="here/bobobase_modification_time" > 
2003/07/08 14:35:10 </span> 

On peut egalement combiner plusieurs expressions simples alternatives comme 
dans l'exemple suivant : 

<span tal : content="request/form/custname | here/custname | nothing" > 
Norn du client </span> 

Expressions de type « not » 

Les expressions de ce type permettent d'effectuer une negation sur une expres- 
sion de type path. Son utilisation est tres simple : il faut la voir comme une 
extension triviale du type path. En effet, en ajoutant simplement le mot-cle 
not: devant une expression path, la valeur booleenne de celle-ci est inversee. 
Cela s'avere fort pratique pour simuler une condition de type el se, comme dans 
l'exemple ci-dessous, qui permet d'afficher le resultat d'un formulaire dans 
lequel une variable peut etre cochee ou pas : 

<div tal :condition="request/maVariable"> 

Vous avez coche la case 
</div> 

<div tal :condition="not: request/maVariable"> 

Vous n'avez pas coche la case 
</div> 



Expressions de type « string » 

Elles permettent de combiner une expression simple avec du texte, ou plusieurs 
petites expressions simples, dans la meme operation. La combinaison se fait par 
concatenation des chaines de caracteres, d'ou le nom de ce type d'expressions. 
Le prefrxe utilise est stri ng. 

Voici quelques exemples simples avec ce type d'expression : 

I <span tal :content="stn'ng:Bienvenue ${user/getUserName} !" > 
Bienvenue jdupont !</span> 

<span tal :content="stn'ng: Date de modification : ${here/ 

bobobase_modification_time}" > 
2003/07/08 14:35:10 </span> 

Expressions de type « nocall » 

Une expression de type path rend l'objet quelle evalue. Dans certains cas rares, 
le resultat de l'expression est un objet Zope executable et vous ne voulez pas 
qu'il soit rendu. Le prefrxe utilise est nocall. Le cas typique est celui d'un objet 
de type DTML Document auquel on veut acceder simplement pour recuperer et 
afficher ses proprietes. 
Voici un exemple : 

<div tal :define="doc nocall :here/mondoc" 

tal :content="string:${mondoc/getId}: ${doc/title}"> 
<a href="" tal :attributes="href doc/absol ute_url " 
tal :content="here/title">Titre du doc </a> 

</di v> 

Expressions de type « exists » 

Une expression de type exi sts est similaire a une expression de type path, sauf 
qu'au lieu de retourner une valeur (la valeur de l'objet ou attribut auquel on 
accede), elle teste simplement son existence. 

Ce type d'expression est peu utilise, mais est prevu par le langage pour apporter 
de la souplesse dans des cas ou Ton doit faire plusieurs traitements sur la meme 
balise, dont le test du resultat de l'un de ces traitements. 
En voici un exemple : 

<p tal :condition="exists: request/form/notitymessage" 

tal :content="request/form/notitymessage"> Notification </p> 

Expressions de type « python » 

Elles permettent d'evaluer du code Python (['equivalent des « expressions 
Python » dans le contexte du DTML) pour une operation TAL. Le prefrxe uti- 
lise est python. 



Voici quelques exemples simples avec ce type d'expression : 

<span tal : content="python : 1 en (contai ner . dossi er . objectVal ues ( 

['File', 'Image']))" >12</span> fichiers 
Date de modification : 

<span tal : replace="python:here.bobobase_modification_time. 

strf ti me( '%d/%m/%Y ' ) ">08/07/2003</span> 

Ce type d'expression est celui qui apporte le plus de flexibilite pour traiter des 
operations complexes, puisque Ton a acces a la puissance de Python. De plus, il 
est possible d'utiliser un autre type d'expression tel que path ou string au sein 
d'une expression python. Ceci est possible parce qu'une fonction Python est dis- 
ponible pour chaque type d'expression que Ton voudrait utiliser au sein d'une 
expression python. Ce sont les fonctions qui portent le meme nom : path(), 
stringO, exists() et nocall (). 

On peut done utiliser des expressions de type python comme dans les exemples 
suivants : 

<span tal : replace="python:path('here/%s/title_or_id' % 

dossiercourant)" /> 
<span tal : replace="python:path(' request/form/membername | 

here/membername | nothing') or 'Invite'" /> 



Espace de nommage 

L'espace de nommage des Pages Templates contient quelques variables impli- 
cites dont la liste est presentee ci-apres. 



user 


Cette variable represente I'objet correspondant a I'utilisateur connecte. Elle fournit ainsi I'acces au nom de 
I'utilisateur et a ses roles et permissions. 

Dans le monde DTML, cette variable s'appelle AUTHENTICATEDJSER. 

Ex.: Bienvenue <b tal : content="user/getUserName">Nom utilisateur</b> 


here 


Cette variable correspond au contexte d'execution de la page en cours. C'est sur cette variable que Ton retrouve 
les variables de la pile d'acquisition par exemple. Cette variable est tres proche de la variable context, que nous 
rencontrerons dans les Python Scripts. 

Ex. : Le titre de cette page est <span tal : replace="here/title">titre du repertoire en 
cours</span>. 


request 


La variable REQUEST de Zope est ainsi accessible. Elle porte les informations relatives a la connexion HTTP en 
cours. 


template 


Cette variable represente I'objet page template lui-meme. 

Elle peut etre utile dans des cas rares, comme pour afficher le nom de la tempi ate dans le titre. 


nothing 


Cette valeur speciale permet d'effacer une balise ou son contenu selon qu'elle est utilisee dans un tal : replace 
ou un tal : content, ou un tal : attributes. 
Ex : <p tal : replace="nothing"> 

Commentaire : cette information est susceptible de changer. </p> 
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default 


Cette valeur speciale n'affecte aucune modification a la balise lorsqu'elle est utilisee dans un tal : replace, 

tal : content, ou tal :attri butes. Elle conserve intact le texte auquel s'applique la balise. 

Ex. : Statut : <span tal :content="python:here.getStatus() or default">N/A</span>. 


options 


Si des arguments de type keyword sont envoyes a la template apres I'execution d'un script, ceux-ci sont 
disponibles dans la variable opti ons. 

Ex. : <div tal :condition="options/error_message nothing"> 
<b>Erreur : <span tal :content="options/error_message" > 
Le message d'erreur 
</spanx/b> 

</div> 


attrs 


Cette variable est le dictionnaire des attributs de la balise courante dans la template. Les des du dictionnaire 
sont les noms des attributs et ses valeurs correspondent aux valeurs d'origine des attributs (avant le rendu de la 
template). 

Flip pqt rarpmpnt ntilispp 

1_MC OL 1 dl CI 1 ICI 11 UUII3CC 


root 


Cette variable represents I'objet racine de Zope. 

Elle peut etre utile pour acceder a des objets donnes de I'arborescence de Zope. 


container 


Cette variable represents le conteneur (generalement un repertoire) de I'objet template. 

Ex.: Cette template est hebergee dans le dossier : <span tal : replace="container/ 

title_or_id">titre du conteneur de la tempi ate</span>. 


modules 


Cette variable contient la collection des modules Python que Ton peut utiliser au sein d'une template 
Ex. : 

<div tal :define="string modules/string"> 

<span tal :content="python:string.upper(here.title_or_id())" /> 

</div> 





METAL 

METAL (Macro Expansion Template Attribute Language) est le systeme qui 
permet de reutiliser des blocs entiers de code d'une template donnee au sein 
d'une autre template. C'est le mecanisme des macros. En proposant au deve- 
loppeur une « approche objet » dans la maniere de mettre en oeuvre les skins 
(couches de presentation du site), les macros apportent un gain en qualite et en 
maintenabilite pour des sites ou des systemes de gestion de contenu complexes. 

Principe d'une macro 

Une macro regroupe un certain nombre d'elements de code HTML d'une 
template afin de les reutiliser dans d'autres templates. Elle s'applique a la balise 
qui delimite le bloc de code concerne, et elle porte un nom. 
La macro contient generalement un (sous-)bloc vide (ou plusieurs) appele slot 
(litteralement : tiroir), que Ton remplit avec du code specifique dans chaque 
tempi ate ou Ton utilise la macro. 
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Les fonctions du langage METAL 

La grammaire de METAL est similaire a celle de TAL, mais elle ne fournit que 
les quatre commandes suivantes : 

• def i ne-macro, qui permet de definir une macro ; 

• define-slot, qui permet de definir un bloc de code personnalisable au sein 
d'une macro ; 

• use-macro, qui permet d'utiliser une macro deja definie ; 

• f i 1 1 -slot, qui permet de personnaliser une slot au sein de la macro utilisee. 



Syntaxe generate 
d'une fonction METAL 



<balise-de-bloc metal :commande= 
"chemin ou nom"> 



</balise-de-bloc> 
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L'API de Plone 



SOMMAIRE 

► Objets de contenu 

► Composants de service 
Les builtins de I'interface 



Classe ] heritage | methode | fonction | variable 





SkinnableObjectManager PortalFolder 




Nous presentons ici les elements les plus utilises de I'API de Plone : les principales 
classes de contenu, les classes de composants (ou Tools), et les variables builtins 
qui permettent d'avoir acces aux services du site Plone. 



Objets de contenu 



Module Products.CMFPIone.PloneContent 

Classe PloneContent 
Classes de base 

Products . CMFCore . Portal Content . Portal Content 

Methodes et fonctions 

fail If Locked (self) 

SearchableText(self) 

view(self) 

Module Products.CMFCore.PortalContent 

Classe PortalContent 

Classes de base 

Products . CMFCore . Dynami cType . Dynami cType 
Products . CMFCore . CMFCatal ogAware . CMFCatal ogAware 
OFS . Si mpl eltem . Si mpl eltem 

Methodes et fonctions 

fail If Locked (self) 

SearchableText(self) 

view(self) 



Figure B-1 

Les classes de contenu CMF 
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Module Products.CMFPIone.PloneFolder 



Classe PloneFolder 



Classes de base 

Products . CMFP1 one . PI oneFoi der . BasePi oneFoi der 
Products. CMFP1 one. PloneFolder.OrderedContainer 

PloneFolder 




+setTitleO 
♦setDescriptionO 
+editO 

♦allowedContentTypesO 
+manage_addPortalFolderO 
♦contentldsO 
+contentValuesO 
♦listFolderContentsQ 
+contentltemsO 
♦TitleO 

♦DescriptionO 
♦TypeO 

♦encodedFolderFilterO 
♦decodedFolderFilterO 
+content_t/peO 
♦invokeFactoryO 
♦checkldAvailableO 

Folder Listing 



portaljypes 

^ +listTypelnfoO 
+listContentTypesQ 



I 



folderjisting 



Local Roles 



\ 

folder_localrole_form 




Figure B-2 

La classe PloneFolder 



Classe BasePloneFolder 

Classes de base 

Products . CMFDef aul t . Ski nnedFoi der . Ski nnedFoi der 
Products . CMFDef aul t . Dubl i nCore . Def aul tDubi i nCorelmpi 

Methodes et fonctions 

contentValues(seif , spec=None, fi"lter=None, sort_on=None, reverse=0) 
f oi deri i sti ngFol derContents (self, spec=None , contentFi 1 ter=None , 

suppressHi ddenFi 1 es=0) 
invokeFactory(seif , type_name, id, RESPONSE=None, -args, **kw) 



*args est un tuple d'arguments non nommes. 
**kw est un dictionnaire d'arguments nommes. 
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listFolderContents(self , spec=None, contentFilter=None, 

suppressHiddenFiles=0) 
manage_addPloneFolder(self , id, title=", REQUEST=None) 
manage_del Objects (self , ids=[], REQUEST=None) 
manage_renameObject(self , id, new„id, REQUEST=None) 

Classe OrderedContainer 
Classes de base 

OFS. Folder. Folder 

Methodes et fonctions 

getObjectPosition(self , id) 

manage_renameObject(self , id, newHd, REQUEST=None) 
moveObject(self , id, position) 
moveObjectToPosition(self , id, position) 
moveObjectsByDelta(self , ids, delta) 
moveObjectsDown(self , ids, delta=l, RESPONSE=None) 
moveObjectsToBottom(self , ids, RESPONSE=None) 
moveObjectsToTop(self , ids, RESPONSE=None) 
moveObjectsUp(self , ids, delta=l, RESPONSE=None) 
orderObjects(self , key, reverse=None) 

Composants de service 

Module Products.CMFPlone.CatalogTool 

Classe CatalogTool 

Classes de base 

Products . CMFCore . Catal ogTool . Catal ogTool 

Methodes et fonctions 

enumeratelndexes(self) 
indexObject(self , object, idxs=[]) 
mi gratelndexes (sel f ) 



Q_ 

Module Products.CMFCore.CatalogTool 

Classe CatalogTool 

Classes de base 

Products . CMFCore . uti 1 s . Uni queObject 
Products . ZCatal og . ZCatal og . ZCatal og 
Products. CMFCore. Acti onProvi de rBase .ActionProviderBase 

Methodes et fonctions 

searchResults(self , REQUEST=None, **kw) 
catalog_object(self , object, uid, idxs=[]) 
enumerateColumnsCself) 
enumeratelndexes(self) 
indexObject(self , object) 
reindexObject(self , object, idxs=[]) 
unindexObject(self , object) 

Classe IndexableObjectWrapper 
Methodes et fonctions 

all owedRolesAndUsers (self) 

Module Products.CMFPlone.ActionsTool 

Classe ActionsTool 
Classes de base 

Products. CMFCore. ActionsTool .ActionsTool 

Methodes et fonctions 

1 i stFi 1 teredActi onsFor (sel f , object=None) 

Module Products.CMFCore.ActionsTool 

Classe ActionsTool 
Classes de base 

Products . CMFCore . uti 1 s . Uni queObject 
OFS. Folder. Folder 

Products . CMFCore .Acti onProvi de rBase .Acti onProvi de rBase 
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Methodes et fonctions 

addActionProvider(self , provide r_name) 
del eteActionProvider (self, provide r_name) 
li stActionProviders(self) 
listFilteredActionsFor(self , object=None) 
manage_aproviders(self , apname='', chosen=(), add_provide 
de"l_provider=0, REQUEST=None) 

Module Products.CMFPlone.DiscussionTool 

Classe DiscussionTool 
Classes de base 

Products . CMFDef aul t . Di scussi onTool . Di scussi onTool 

Methodes et fonctions 

cookReply(self , reply, text_format=None) 

Module Products.CMFCore.DiscussionTool 

Classe DiscussionTool 
Classes de base 

Products. CMFCore.utils.UniqueObject 
OFS . Si mpl eltem . Si mpl eltem 

Methodes et fonctions 

getDiscussionFor(self , content) 

i sDi scussi onAl 1 owedFor (sel f , content) 

listActions(self , info) 

Module Products.CMFPIone.FactoryTool 

Classe FactoryTool 
Classes de base 

Products . CMFCore . uti 1 s . Uni queObj ect 
OFS . Si mpl eltem . Si mpl eltem 

Methodes et fonctions 

doCreate(self , obj , id=None, **kw) 



Q_ 

<st 
-o 

fixRequest(self) § 
getFactoryTypes(self) "i" 

CQ 

getTempFolder(self , type_name) 
isTemporary(self , obj) 

manage_set Portal FactoryTypes (self, REQUEST=None , 1 i stOfTypeIds=None) 

Classe TempFolder 
Classes de base 

Products . CMFP1 one . PI oneFol der . PI oneFol der 

Methodes et fonctions 

getOwner(self , info=0, aq_get=, UnownableOwner=[] , getSecurityManager=) 

getPhysical Path (self) 

get_local_roles_for_userid(self , use rid) 

get_val i d_useri ds (sel f ) 

has_l ocal _rol es (sel f ) 

manage_renameObject(self , idl, id2) 

owner_info(self) 

userCanTakeOwnership(self) 

userdef i ned_rol es (sel f ) 

valid_roles(self) 

validate_roles(self , roles) 

Module Products.CMFPIone.GroupDataTool 

Classe GroupDataTool 

Classes de base 

Products. CroupUser Folder. GroupDataTool .GroupDataTool 

Module Products.CMFPIone.GroupsTool 

Classe GroupsTool 
Classes de base 

Products. GroupUser Folder. GroupsTool .GroupsTool 
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? Module Products.CMFPlone.MemberDataTool 

3 

<V 

E 
E 

g, Classe MemberData 

o 
>— 
a. 

f Classes de base 

.Si 

q Products. CMFCore.MemberDataTool .MemberData 

Classe MemberDataTool 
Classes de base 

Products. CMFCore. MemberDataTool .MemberDataTool 

Methodes et fonctions 

pruneMemberDataContents(self) 

Module ProductsXMFCore.MemberDataTool 

Classe MemberData 
Classes de base 

OFS . Si mpl eltem . Si mpl eltem 

Methodes et fonctions 

getDomains(self) 

getld(self) 

getMemberld(self) 

getPassword(self) 

getProperty(self , id, default=[]) 

getRoles(self) 

getRolesInContextCself , object) 
getTool (self) 
getUser(self) 
getUserName(self) 

has_role(self , roles, object=None) 
noti f yModi f i ed (sel f ) 
setMemberProperties(self , mappi ng) 
setProperties(self , properties=None, **kw) 

setSecurityProfile(self , password=None, roles=None, domains=None) 
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Classe MemberDataTool 
Classes de base 

Products . CMFCore . uti 1 s . Uni queObject 

OFS . Si mpi eltem . Si mpl eltem 

OFS. PropertyManager. PropertyManager 

Products . CMFCore . Acti onProvi derBase . Acti onProvi derBase 

Methodes et fonctions 

getMemberDataContents(seif) 
pruneMemberDataContents(seif) 
registerMemberData(self , m, id) 

searchMemberDataContents(seif , searchjaram, search_term) 
wrapUser(self , u) 

Module Products.CMFPlone.MembershipTool 

Classe MembershipTool 
Classes de base 

Products . CMFDef aul t . Membershi pTooi . Membershi pTool 

Methodes et fonctions 

changeMemberPortrait(self , portrait, member_id=None) 
c reateMemberarea(sel f , membe r_i d=None) 
c reateMemberarea(sel f , membe r_i d=None) 
deietePersonal Port rait (self , membe r_id=None) 
getAuthenti catedMember (sei f ) 
getPersonai Folder (self, membe r_id=None) 

getPersonaiPortrait(seif, member_id=None, verifyPermission=0) 

iistMemberlds(seif) 

iistMembers(seif) 

searchForMembers(self , REQUEST=None, **kw) 
setPassword(seif , password, domains=None) 
testCurrentPassword(seif , password, username=None) 
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Module Products.CMFCore.MembershipTool 

Classe MembershipTool 
Classes de base 

Products . CMFCore . uti 1 s . Uni queObj ect 
OFS .Simp! eltem . Si mpl eltem 

Products .CMFCore. ActionProviderBase.ActionProviderBase 

Methodes et fonctions 

addMember(self , id, password, roles, domains, properties=None) 

checkPe mission (self , permissionName, object, subobjectName=None) 

createMemberarea(self , member_id) credentialsChanged(self , password) 

deleteLocalRoles(self , obj , member_ids, reindex=l) 

getAuthenticatedMember(self) 

getCandi dateLocal Rol es (self, obj ) 

getHomeFolder(self , id=None, verifyPermission=0) 

getHomeUrl (self , id=None, verifyPermission=0) 

getMappedRole(self , portal_role) 

getMemberById(self , id) 

getMemberareaCreationFlag(self) 

getPortalRoles(self) 

isAnonymousUser(self) 

li stMembe rids (self) 

listMembers(self) 

searchMembers(self , search_param, search_term) 
setLocalRoles(self , obj, member_ids, member_role, reindex=l) 
setMemberareaCreationFlag(self) 
setPassword(self , password, domai ns=None) 
setRoleMapping(self , portal_role, userfolder_role) 
wrapUser(self , u, wrap_anon=0) 

Module ProductsXMFPlone.MetadataTool 

Classe MetadataTool 

Classes de base 

Products . CMFDef aul t . MetadataTool . MetadataTool 
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Module Products. CMFDefault.MetadataTool 



Classe MetadataTool 
Classes de base 

Products . CMFCore . uti 1 s . Uni queObject 
OFS . Si mpl eltem . Si mpl eltem 

Products . CMFCore . Acti onProvi derBase . Acti onProvi derBase 

Methodes et fonctions 

editProperties(self , publisher=None, REQUEST=None) 
addElementPol icy (self, element, content^type, is_required, 

supply_default, default_value, enforce_vocabulary, 

al 1 owed_vocabul ary , REQUEST=None) 
removeElementPol icy (self , element, content_type, REQUEST=None) 
updateElementPolicy(self , element, content_type, is_required, 

supply_default, default_value, enforce_vocabulary, 

al 1 owed_vocabul ary , REQUEST=None) 
listElementSpecs(self) 
getElementSpec(self , element) 

addElementSpec(self , element, is_multi_valued, REQUEST=None) 
removeElementSpec(self , element, REQUEST=None) 
listPolicies(self , typ=None) 
getFullName(self , userid) 
getPublisher(self) 

listAllowedVocabul ary (self , element, content=None, content_type=None) 
listAllowedSubjects(self , content=None, content_type=None) 
listAllowedFormats(self , content=None , content_type=None) 
listAllowedLanguages(self , content=None, content_type=None) 
listAllowedRights(self , content=None, content_type=None) 
setlnitial Metadata (self, content) 
validateMetadata(self , content) 

Module Products. CMFPIone.RegistrationTool 

Classe RegistrationTool 
Classes de base 

Products . CMFDef aul t . Regi st rati onTool . Regi strati onTool 



o 




gene ratePassword (self) 
generateResetCode(self , salt, length=14) 
getPassword(self , length=5, s=None) 
isValidEmail (self , email) 



Methodes et fonctions 



Module Products.CMFCore.RegistrationTool 

Classe RegistrationTool 

Classes de base 

Products. CMFCore.utils.UniqueObject 
OFS . Si mpl eltem . Si mpl eltem 

Products .CMFCore. ActionProviderBase.ActionProviderBase 

Methodes et fonctions 

addMember(self , id, password, roles=(' Member' ,) , domains='' 

properties=None) 
afterAdd(self , member, id, password, properties) 
gene ratePassword (self) 
isMemberldAl lowed (self, id) 
i sRegi st rati onAl 1 owed (sel f , REQUEST) 
mailPassword(self , forgotten_userid, REQUEST) 
testPasswordValidity(self , password, confi rm=None) 
testPropertiesValidity(self , new_properties, member=None) 

Module Products.CMFPlone.SkinsTool 

Classe SkinsTool 
Classes de base 

Products . CMFCore . Ski nsTool . Ski nsTool 

Module ProductsXMFCore.SkinsTool 

Classe SkinsTool 
Classes de base 

Products . CMFCore . uti 1 s . Uni queObj ect 

Products .CMFCore . Ski nsContai ner . Ski nsContai ner 
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OFS. Folder. Folder 

Products . CMFCore . Acti onProvi derBase . Acti onProvi derBase 

Methodes et fonctions 

PUT_factory(self , name, typ, body) 

addSkinSelection(self , skinname, skinpath, test=0, make_default=0) 

cl earSki nCache (sel f ) 

cl earSki nCooki e(sel f ) 

getAl 1 owAny (sel f ) 

getCooki ePersi stence (sel f ) 

getDefaultSkin(self) 

getRequestVarname(self) 

getSkinByName(self , name) 

getSkinPath(self , name) 

getSkinPaths(self) 

getSki nSel ecti ons (sel f ) 

manage_afterAdd(self , item, container) 

manage_afterClone(self , item) 

manage_beforeDelete(self, item, container) 

manage_properties(self, default_skin=' ' , request_varname=' ' , 
allow_any=0, chosen=(), add_skin=0, del_skin=0, skinname='', 
skinpath='', cookie_persistence=0, REQUEST=None) 

manage_rel oadSki ns (sel f , REQUEST=None) 

manage_skinl_ayers(self, chosen=(), add_skin=0, del_skin=0, skinname 

skinpath=", REQUEST=None) 
reloadDVS(self , dvs, parent=") 
testSkinPath(self , p) 
updateSki nCooki e(sel f ) 

Module Products.CMFPIone.TypesTool 

Classe TypesTool 



Classes de base 

Products. CMFCore. TypesTool .TypesTool 



Module Products.CMFCore.TypesTool 

Classe FactoryTypelnformation 
Classes de base 

Products . CMFCore . TypesTool . Typelnf o rmati on 

Methodes et fonctions 

constructInstance(self , container, id, *args, **kw) 
isConstructionAll owed (self, container) 

Classe ScriptableTypelnformation 

Classes de base 

Products . CMFCore . TypesTool . Typelnf o rmati on 

Methodes et fonctions 

constructInstance(self , container, id, *args, **kw) 
isConstructionAll owed (self, container) 

Classe Typelnformation 

Classes de base 

Products . CMFCore . uti 1 s . Si mpl eltemWi thProperti es 
Products .CMFCore. ActionProviderBase.ActionProviderBase 

Methodes et fonctions 

Description(self) 
Metatype(self) 
Title(self) 
Type(self) 

al 1 owDi scussi on (sel f ) 

all owType (self, contentType) 

getActionByldCself , id, default=[]) 

getlcon(self) 

getld(self) 

globalAllow(self) 

listActionsCself , info=None) 



o_ 

o> 

Classe TypesTool g 
Classes de base 00 

Products . CMFCore . uti 1 s . Uni queObject 
OFS. Folder. Folder 

Products. CMFCore. ActionProviderBase .ActionProviderBase 

Methodes et fonctions 

constructContent(self , type_name, container, id, RESPONSE=None, *args, 
**kw) 

getTypeInfo(self , contentType) 
listActions(self , info=None) 

listContentTypes(self , container=None, by_metatype=0) 
1 i stDef aul tTypelnf ormati on (sel f ) 
1 i stTypelnf o(sel f , contai ner=None) 
manage_addFactoryTIForm(self , REQUEST) 
manage^addScri ptabl eTIForm(sel f , REQUEST) 
manage_addTypeInformation(self , add_meta_type , id=None, 
typei nf o_name=None , RESPONSE=None) 



Products.CMFPIone.URLTool 

Classe URLTool 
Classes de base 

Products . CMFCore . URLTool . URLTool 



Module Products.CMFCore.URLTool 

Classe URLTool 
Classes de base 

Products . CMFCore . uti 1 s . Uni queObject 
OFS . Si mpl eltem . Si mpl eltem 

Products. CMFCore. ActionProviderBase .ActionProviderBase 

Methodes et fonctions 

getPortalObject(self) 

getPortal Path (self) 

getRelati veContent Path (self , content) 

getRelativeContentURL(self , content) 
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Products. CMFPIone.WorkflowTool 

Classe WorkflowTool 

Classes de base 

Products .CMFCore. WorkflowTool .WorkflowTool 

Methodes et fonctions 

doActionFor(self , ob, action, wf_id=None, *args, **kw) 
flattenTransitions(self , objs, contai ner=None) 
getChainForPortalType(self , pt_name, managescreen=0) 
getTransitionsFor(self , obj=None, contai ner=None, REQUEST=None) 
getWorklists(self) 
1 i stWo rkf 1 ows (sel f ) 
wo r kf 1 ows_i n_u se ( s e 1 f ) 

Products.CMFCore.WorkflowTool 

Classe WorkflowTool 

Classes de base 

Products . CMFCore . uti 1 s . Uni queObj ect 
OFS. Folder. Folder 

Methodes et fonctions 

doActionFor(self , ob, action, wf_id=None, *args, **kw) 

getActionsFor(self , ob) 

getCatalogVariablesFor(self , ob) 

getChainFor(self , ob) 

getDefaultChainFor(self , ob) 

getHistoryOf (self , wf_id, ob) 

getInfoFor(self , ob, name, default=[], wf_id=None, -args, **kw) 

getStatusOf(self , wf_id, ob) 

getWorkflowById(self , wf_id) 

getWorkf 1 owlds (self) 

getWorkflowsFor(self , ob) 

listActions(self , info) 

manage_addWorkflow(self , workflow_type, id, RESPONSE=None) 
manage_addWorkflowForm(self , REQUEST) 

manage_changeWorkfl ows (self , default_chain, props=None, REQUEST=None) 
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Q_ 

<st 
■a 

manage_selectWorkflows(self , REQUEST, manage_tabs_message=None) § 
notifyBefore(self , ob, action) "i" 

CO 

notifyCreated(self, ob) 
notifyException(self, ob, action, exc) 
notifySuccess(self, ob, action, result=None) 
setChainForPortalTypes(self , pt_names, chain) 
setDef aul tChai n (self, def aul t_chai n) 
setStatusOf (self , wf_id, ob, status) 
updateRoleMappings(self , REQUEST=None) 
wrapWorkflowMethod(self , ob, method_id, func, args, kw) 



Les builtins de r interface utilisateur 

Variables globales des templates 

Ces variables sont disponibles dans tous les 
templates de I'interface utilisateur. 



Variables d'acces aux composants de service (Tools) 



Variable 


Definition 


utool 


I'objet URL Tool 


porta~l_properties 


I'objet Properties Tool 


mtool 


I'objet Membership Tool 


gtool 


I'objet Groups Tool 


gdtool 


I'objet Groupdata Tool 


atool 


I'objet Actions Tool 


aitool 


I'objet Actionlcons Tool 


putils 


I'objet Plone (Utils) Tool 


wtool 


I'objet Workflow Tool 


Autres variables de templates 




portal 


le site Plone 


portal_url 


I'adresse URL absolue du site 



Pour faciliter le travail des developpeurs, de nombreux objets ou services sont 
directement accessibles via des variables globales qui sont definies au sein de 
tempi ateglobal_defines appelee au debut du template principal de Plone 
(main_template). 
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checkPermi ssi on 


la methode permettant de verifier que le mem- 
bre authentifie possede une permission donnee 


i sAnon 


s'il existe, I'utilisateur n'est pas encore authenti- 
fie (anonyme) 


actions 


la liste de toutes les actions contextuelles 


user_acti ons 


la liste des actions personnelles 


workf ~low_acti ons 


la liste des actions exposees par le workflow 


folder_actions 


la liste des actions portees par le dossier courant 


portal_tabs 


la liste des actions exposees sous forme 
d'onglets de type portal_tab 


site_properties 


la fiche de proprietes stockant les parametres 
generaux 


isFolder 


s'il existe, I'objet courant est un dossier (Folder) 


here_url 


I'adresse URL absolue de I'objet courant 


defaultjl anguage 


la langue par defaut du site 



Variables pour les expressions de parametrage d'une 
action 

Le composant ActionsTool ajoute les variables suivantes pour les expressions 
TALES utilisees dans les champs Action et Condition d'une action : 



Variable Definition 


portal 


le site Plone 


portal_url 


I'URL absolue du site 


folder 


le dossier courant (dans lequel on se trouve) 


folder_url 


I'URL absolue du dossier courant 


object 


I'objet courant (sur lequel on se trouve) 


object_url 


I'URL absolue de I'objet courant 


member 


le membre authentifie (s'il y a eu authentica- 
tion d'un utilisateur) 


request 


la requete HTTP envoyee au serveur 


modules 


le conteneur des modules Python autorises dans 
une Page Template (ex. string, ZTUtils, etc.) 
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Aide-memoire 
Archetypes 




SOMMAIRE 

► Aide-memorie pour les champs 
(field) 

► Aide-memoire pour les widgets 

MOTS-CLES 

► Widget 

► Field 

► Proprietes 

► Schema 



Widget | Field | proprietes | schema 



3plone.org - Archetypes l.Z.5-rc4 Field Reference - Microsoft Internet 


Ewplorer 


rrr 


Fichier Edition Affichage Favcris Oubfa ? 






Adresse |e] http://plone.org/documentation/archetype5/arch_field_quickref_l_Z_5_rc4 


_J ^OK | L»ns » 



a propos | | actualites | | telechargements | I documentation | | developper 



| A 1 1 of plone.org __] A rechercher 



vous etes ici ; accueil x documentation * archetypes » archetypes l,2.5-rc4 field reference 



CD About Plone 
CD Downloads 
CD Documentation 

CD Errata 

CD Plone Book 

_j Archetypes 

CD Zope 

CD Python 

CD What 1 s New 

CD Tutorials and 

CD Online Chat 

CD APIs 

CD Mailing Lists 

CD Frequently Asked 

Q 

CD Migration 
between 

__] [ 'rvr-luprnrrit 

CD Events 



Archetypes 1.2.5-rc4 Field Reference 

Gives a quick overview of all properties of the default Archetypes 1.2.5 rc4 fields. 

Feedback to: Meik Rtider, raeder@berg.net 

When you are using Fields in a Schema, it is important to be aware of all the properties that are defined by default for 
Fields. The following table shows the properties of the Field class, which all specific Fields have a copy of or override. 
Refer to the specific Field reference further down to see which properties are redefined. 

In the following table, the standard Field properties are shown in the first column. The next column shows their default 
value. When you know the defaults you can avoid redefining the properties with the same values as the default ones 
when you define your custom Fields, In the last column, you will find a description of what the property is about. 



Nom d'utilisateur 



widget 
schemata 

vocabulary 



default 

StringWidget 
'default' 



Modify PortalContent 



The default 
reference to 



i i 1 at i ; 



■ Strlr 



n tha 



f tha 



without the read n 



.ntiated, 

is default 
d. 

:reated 



s set to an instance of the referenced Str r.gW ccc- 
wn Schemata? to deal with group;, of Field;, separa 
It". For metadata Fields, the "metadata" Schemati 
i can include read and write access. Accessors will i 
)de. and Mutators will not be created without the wi 
The View Permission, as defined in CMFCorePermissions, is used to check whether the 
current user is allowed to see the Field in read mode, Only interesting if the read mode 
is activated. The read permission is checked when rendering the widget in read mode. 
The ModifyPortalContent Permission, a; defined in CMFCorePermissions, is used to 
check whether the current user is allowed to fill in the Field in write mode. Only 
s activated, The write permission is checked when 



widget 



irita 



: 



Cette annexe decrit les champs et widgets Archetypes, deja rencontres au 
chapitre 7. El le tiendra lieu de reference au developpeur souhaitant exploiter les 
possibilites de cette technologie. 



► http://plone.org/documentation/archetypes/ 
arch_field_quickref_1_2_5_rc4 



Maik Rbder, roeder@berg.net 



Aide-memoire pour les champs (field) 

Pour utiliser des champs dans la definition d'un schema, il est important de 
connaitre les proprietes definies par defaut pour un champ. Le tableau ci- 
dessous contient toutes les proprietes de la classe Field. Lorsqu'on connait les 
valeurs par defaut, on peut definir des schemas plus compacts. Une propriete ha 
besoin d'etre specifiee que si sa valeur est differente de la valeur par defaut. 



Norn de la propriete 


Valeur par defaut 




widget 


StringWidget 


Le widget par defaut est de type Stri ngWidget. L'attribut widget n'est pas specifie par 
une chaine, mais par une reference vers sa classe. Au moment de ['initialisation d'un champ, 
le widget est instancie. 


schemata 


'default' 


Un schemata permet de travailler avec plusieurs groupes de champs. Le schema par defaut 
est default. Pour les metadonnees, le schemata est metadata. 


mode 


rw 


Par defaut, les modes ecriture (w) et lecture (r) sont actives pour les champs. En I'absence du 
mode lecture, aucun accessor n'est cree. Aucun mutator n'est cree en I'absence du mode 
ecriture. 


rpaH normiccinn 

1 CdU_|Jcl 1 1 1 IbbILM 1 


VlGW 


1 a nprmiccinn oui pet Hpfin ip Ha nc CM Pf nroPorrvH ccinnc F p cpnt a \/prifipr ci i in 
Ld [Jcl 1 1 1 IbblUI 1 V 1 cW cbl Ucl II lie Udl lb LrlrLU 1 crcl III 1 b b 1 Ul 1 b . Lllc bcl L d Vcllllcl bl Ull 

utilisateur peut voir un champ en mode lecture. Ce n'est interessant que si le mode lecture 
est actif. La permission est verifiee au moment oil le widget est restitue. 


write_permission 


ModifyPortalContent 


La permission ModifyPortalContent est aussi definie dans CMFCorePermissions et sert 

a wprifipr Ip rlrnit H'arrpc a un rhamn lnrc Hp la rpctitiitinn on mnrlp prritiirp 
d Vcllllcl le UIUIL U dLLcb d Ull Llldlll|J lUlb Uc Id ICbLILULIUII Cl 1 IIIUUC CLIILUIC. 


vocabulary 


0 


La propriete vocabulary definit le vocabulaire d'une liste de choix. Par defaut, c'est un 

tun o \/iHp cinnn r pet imp inctanrp Hp a Ha ceo cnl a\/l i ct 

LUUIC VlUc , blllUII L CbL Ullc II lb Ldl ILc Uc Id LldbbC UlbpiayLlbL. 


enforceVocabulary 


0 


La propriete enforceVocabulary permet de controler la bonne utilisation des valeurs 

H' i inp lictp Hp rhniy Hpf inip nar la nrnnriptp \/r»r"ahii1 ar\/ 

U Ullc IIMC Uc LI IUIA Ucl II lie [Jdl Id Ul UUI IcLc VULdUU idi y. 


cparrhahlp 
bcdl LI idUlc 


n 

u 


InHimiP ci im rhamn pet inHpyp nar a mothnno Coa rr^hahl oTovf Pa r Hpfai it p rhamn np 

IIIUILjUc bl Ull Ll Id 1 1 l[J CbL II lUCAC Udl Id lllcUIUUc jcdl LlldU 1 c 1 cAL. rdl UcldUL, lc LI Id 1 1 IU lie 

peut pas etre recherche via le Web. Attention : si un champ protege est indexe, n'importe 
quel utilisateur ayant acces au document et faisant une recherche sur un mot contenu dans 
ce champ, pourra en deduire que le mot recherche est contenu dans I'un des champs 
auxquels il n'a pas acces 


index 


None 


Syntaxe : <i ndex_type> ou <i ndex_type> : schema. Si un type d'index est defini, il est 
automatiquement cree dans portal_catal og. Si I'index est specifie avec : schema, le 
champ fera partie des metadonnees de portal_catalog, et sera done accessible dans les 
resultats d'une recherche. 


required 


0 


Un champ obligatoire doit etre rempli dans un formulaire. Par defaut, un champ peut etre 
vide. 


validators 


0 


II s'agit d'une liste de methodes de validation. Par defaut, la propriete est un tuple vide. S'il 
n'y a qu'une seule methode de validation, elle peut etre specifie directement sans tuple. 


default 


None 


II s'agit de la valeur par defaut du champ. 


default_method 


None 


Methode appelee pour obtenir la valeur par defaut. 


storage 


AttributeStorageQ 


La propriete storage definit le type de stockage d'une valeur. Par defaut, la valeur est 
stockee en tant qu'attribut. 



178 



Notes 



mutator 


None 


Methode d'alteration qui permet de modifier un champ d'une instance. Si le nom d'une 
methode n'est pas fourni, Archetypes cree une methode d'alteration par defaut. 


accessor 


None 


Methode d'acces qui permet d'acceder au champ d'une instance sans le modifier. Si le nom 
d'une methode n'est pas fourni, Archetypes cree une methode d'acces par defaut. 


edit accessor 


None 


Une methode qui retourne la valeur brute (raw value) d'un champ peut etre definie ici. 


multivalued 


0 


Definit si un champ peut contenir des valeurs multiples. C'est le cas lorsqu'on utilise des 
listes de choix dans lesquelles on peut selectionner plusieurs valeurs. 


isMetadata 


0 


Utilise pour les champs de metadonnees. Pour le moment, cette information n est utilisee 
que dans la methode filterFields de Schema. 


type 


None 


Le type est specifie pour chaque classe derivee de Fi el d. Cette propriete ne doit pas etre 
modifiee. 


generateMode 


veVc 


Si la valeur de la propriete generateMode contient le caractere c, les methodes d'acces et 
d'alteration du champ sont definies dans la classe. Les modes v, e et V ne sont pas utilises 
dans Archetypes. Cette propriete ne doit pas etre modifiee. 


force 


■ i 


Non utilisee pour I'instant. 



Les proprier.es de Field sont reutilisees ou redefinies dans tous les champs qui 
heritent de Field. Les differences pour chaque type de champs sont donnees ci- 
dessous. 

Champ de type CMF ObjectField 

Utilise des objets de contenu (CMF), dont le type de contenu, et eventuelle- 
ment un workflow associe, a ete defini. Ne peut servir que pour des types de 
contenu fondes sur BaseFolder. 

Proprietes modif iees 



Nom 


Type 


Defaut 


Notes 


widget 


widget 


FileWidget 


Valeur possible : 
• LabelWidget 


storage 


storage 


<Storage ObjectManagedStorage> 




type 




object 





Proprietes specif iques 



Nom 




Defaut 


Notes 


portal_type 




File 




workflowable 




1 




default_mime_type 




application/octet-stream 
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Champ de type DateTimeField 

Sert a stocker des dates. 



Proprietes modif iees 



Nom 


Type 




Notes 


widget 


widget 


CalendarWidget 


Valeurs possibles : 

• LabelWidget 

• CalendarWidget 
(defaut) 


default 


datetime 






type 




datetime 





Champ de type ReferenceField 

Sert a stocker des references vers d'autres objets Archetypes. 
Proprietes modif iees 









Notes 


widget 


widget 


ReferenceWidget 




Valeur possible : 
• LabelWidget 


type 




reference 





Proprietes specifiques 





Notes 


destination 






L'endroit ou creer I'objet si la 
propriete addabf e est active. 


relationship 






Definit le type de relation a 
etablir pour ce champ. Exemples : 
KnowsAbout ou Owns. 


allowed_types 




0 


La liste definit tous les types 
d'objets que I'utilisateur peut 
references 

Indique aussi les types qui 
peuvent etre ajoutes directement 
depuis un widget reference, 
lorsque la propriete addable est 
active. 


addable 




0 


Indique si les types de la 
propriete all owed_types 
peuvent etre addabf e et pas 
seulement referencabfe 


allowed_type_column 




portal_type 





Champ de type TextField 

Sert a stacker du texte qui peut etre transtarme. 
Proprietes modifiees 











default 


string 






type 




text 




Proprietes specif iques 


Norn Type Defaut 




primary 




0 




default_content_type 




text/plain 




allowable_content_ 
types 




('text/plain',) 


Utilise dans les widgets TextArea 
et Visual pour proposer a 
I'utilisateur le choix du format a 
appliquerau contenu saisi. 


default_output_type 




text/plain 


Utilise seulement dans la methode 
get, pour choisir le type MIME a 
appliquer au contenu s'il n'est pas 
precise. 


Champ de type ImageField 

Sert a stacker des images. 
Proprietes modifiees 




widget 


widget 


ImageWidget 


Valeurs possibles : 

• LabelWidget 

• ImageWidget (defaut) 


default 


string 






type 




image 





Proprietes specif iques 



Norn 




Defaut 


Notes 


original_size 








max_size 








default_content_type 




image/gif 




sizes 




{'thumb': (80, 80)} 




image_class 








allowable_content_types 




('image/gif, 'image/jpeg') 





Champ de type FloatField 

Sert a stocker des valeurs decimales. 
Proprietes modif iees 











default 


string 


0.0 




type 




float 





Champ de type StringField 

Sert a stocker une chame de caracteres. 
Proprietes modif iees 



Norn 


Type 






default 


string 






type 




string 





Proprietes specifiques 



Nom 

default_content_type 




Champ de type BooleanField 

Sert a stocker des valeurs booleennes. 
Proprietes modif iees 





Defaut 


Notes 


widget 


widget 


BooleanWidget 


Represents par une case a 
cocher. 

Valeurs possibles : 

• LabelWidget 

• BooleanWidget (defaut) 


default 


boolean 






type 




boolean 




Champ de type FileField 

Sert a stocker des fichiers. 
Proprietes modif iees 






Notes 


widget 


widget 


FileWidget 


Valeurs possibles : 

• FileWidget (defaut) 

• LabelWidget 


type 




file 





Proprietes specif iques 



Norn 








primary 




0 




default_content_type 




text/plain 





I 

-s 



E 

E 
i 
■a 

< 



Champ de type IntegerField 

Sert a stacker des nombres entiers. 
Proprietes modifiees 



Norn 


Type 


Defaut Notes 


widget 


widget 


IntegerWidget 


Valeurs possibles : 

• ReferenceWidget 

• IntegerWidget (defaut) 

• LabelWidget 


default 


integer 


0 




type 




integer 




Proprietes specif iques 


Norn 




Defaut 




size 




10 


La taille maximale d'un 
champ Entier est de 10 
chiffres par defaut. 



Champ de type FixedPointField 

Sert a stacker des valeurs decimales. 
Proprietes modifiees 





Type 


Defaut Notes 


widget 


widget 


DecimalWidget 


Valeurs possibles : 

• DecimalWidget (defaut) 

• LabelWidget 


validators 


validators 


isDecimal 




default 


string 


0.0 




type 




fixedpoint 




Proprietes specif iques 










precision 




2 
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n Champ de type LinesField 

I Sert a stocker des lignes de texte. 



Proprietes modif iees 



3 



Nom 


Type 


Defaut 


Notes 


widget 


widget 


LinesWidget 


Valeurs possibles : 

• SelectionWidget 

• KeywordWidget 

• LabelWidget 

• LinesWidget (defaut) 

• MultiSelectionWidget 


default 


string 


[] 




multivalued 


boolean 


0 




type 




lines 





Champ de type ComputedField 

Champ qui ne peut etre utilise qu'en mode lecture et qui affiche une valeur cal- 
culee par une expression Python. 

Proprietes modif iees 



widget 


widget 


ComputedWidget 


Valeurs possibles : 

• LabelWidget 

• ComputedWidget 
(defaut) 


storage 


storage 


<Storage 

ReadOnlyStorage> 




type 




computed 




mode 


string 


r 




Proprietes specifiques 


Nom 






Notes 


expression 






Evalue sur I'objet pour 
calculer la valeur. 
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Aide-memoire pour les widgets 

Widget de type LabelWidget 

Affiche un label. 
Proprietes 





Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/label 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view 1 : 'visible'} 


show_content_type 




0 


description 







Widget de type StringWidget 

Boite de saisie d'une chaine de caracteres sur une ligne. 
Proprietes 



Norn 




Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/string 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


maxlength 


integer 


255 


size 




30 


show_content_type 




0 


description 







Widget de type IntegerWidget 

Boite pour la saisie de valeurs entieres (Integer). 
Proprietes 









modes 




('view', 'edit') 


populate 


boolean 


1 



O) 

I 

■5 

I— 
< 

"o 

E 

► http://plone.org/documentation/archetypes/ f 
arch_widget_quickref_1 _2_5_rc4 s 
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macro 




widgets/integer 


postback 


boolean 


1 


lauei 






visible 




{'edit': 'visible', 'view': 'visible'} 


maxlength 




255 


size 




5 


show_content_type 




0 


description 







Widget de type DecimalWidget 

Boite de saisie de nombres decimaux. 
Proprietes 



Nom Type 


Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/decimal 


postback 


boolean 


1 


label 






thousands_commas 




0 


visible 




{'edit': 'visible', 'view': 'visible'} 


whole_dollars 




0 


maxlength 




255 


dollars_and_cents 




0 


size 




5 


show_content_type 




0 


description 







Widget de type BooleanWidget 

Case a cocher. 
Proprietes 



modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/boolean 


postback 


boolean 


1 


label 
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Valeur par defaut 


visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 







Widget de type LinesWidget 

Boite de saisie d'une liste de valeurs, chacune etant placee sur une ligne. 
Proprietes 



Norn 


Type 




rows 


integer 


5 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/lines 


postback 


boolean 


1 


cols 


integer 


40 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 







Widget de type SelectionWidget 

Liste de choix avec un seul choix possible, proposee sous forme de liste derou- 
lante (format=select), ou sous forme de menu (format=radio). Par defaut 
(f ormat=f 1 ex), une liste deroulante est utilisee s'il y a plus de trois options, sinon 
c'est un menu. 



Proprietes 







Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


format 




flex (autres choix : select et radio) 


macro 




widgets/selection 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 
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Widget de type MultiSelectionWidget 

Liste de choix avec plusieurs choix possibles, proposee sous forme de liste 
deroulante (format=select), ou sous forme de menu (format=checkbox). 

Proprietes 



Nom 


Type 


Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


format 




select (autre choix : checkbox) 


macro 




widgets/multiselection 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


size 




5 


show_content_Jype 




0 


description 







Widget de type TextAreaWidget 

Boite de saisie de texte. 
Proprietes 



rows 


integer 


5 


modes 




('view', 'edit') 


populate 


boolean 


1 


format 




0 


macro 




widgets/textarea 


postback 


boolean 


1 


cols 


integer 


40 


label 






visible 




{'edit': 'visible 1 , 'view': 'visible'} 


show_content_type 




0 


description 







I 
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Widget de type VisualWidget | 

Boite de saisie utilisant un editeur WYSIWYG. 1 
Proprietes i> 









rows 


integer 


25 


modes 




('view', 'edit') 


populate 


boolean 


1 


format 




0 


macro 




widgets/visual 


postback 


boolean 


1 


cols 


integer 


80 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


width 




507px 


height 




400px 


show_content_type 




0 


description 







Widget de type RichWidget 

Boite de saisie utilisant un editeur WYSIWYG. Offre le choix entre plusieurs 
formats de texte et permet de telecharger un fichier texte. 

Proprietes 





Valeur par defaut 


rows 


integer 


5 


modes 




('view', 'edit') 


populate 


boolean 


1 


format 




1 


macro 




widgets/rich 


postback 


boolean 


1 


cols 


integer 


40 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 
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Widget de type EpozWidget 

Boite de saisie utilisant l'editeur WYSIWYG Epoz. 
Proprietes 







rows 




5 


modes 




('view', 'edit') 


populate 


boolean 


1 


format 




0 


macro 




widgets/epoz 


postback 


boolean 


1 


cols 




40 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 







Widget de type FileWidget 

Boite de saisie utilisee pour telecharger un fichier. 
Proprietes 





Type 


Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/file 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




1 


description 







Widget de type ImageWidget 

Boite de saisie utilisee pour telecharger et afficher une image. 
Proprietes 









display_threshold 




102400 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/image 



Norn 


Type Valeur par defaut 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




1 


description 







Widget de type CalendarWidget 

Boite de saisie d'une date. 
Proprietes 









modes 




('view', 'edit') 


populate 


boolean 


1 


format 






macro 




widgets/calendar 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 







Widget de type PasswordWidget 

Boite de saisie d'un mot de passe. 
Proprietes 



Nom 


Type 


Valeur par defaut 


modes 




('edit',) 


populate 


boolean 


0 


macro 




widgets/password 


postback 


boolean 


0 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


maxlength 




255 


size 




20 


show_content_type 




0 


description 







Widget de type KeywordWidget 

Boite de saisie pour un mot-cle. 
Proprietes 







vocab_source 




portal_catalog 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/keyword 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


size 




5 


show_content_type 




0 


roleBasedAdd 




1 


description 







Widget de type ComputedWidget 

Affiche une valeur calculee, done sans boite de saisie. 
Proprietes 





Type 


Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/computed 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 







Widget de type IDWidget 

Boite de saisie pour le nom court d'un objet. 
Proprietes 









modes 




('view', 'edit') 


populate 


boolean 


1 


display_autogenerated 




1 


macro 




widgets/zid 



pOSIUdCK 


uooiean 


i 


is_autogenerated 




islDAutoGenerated 


label 






visible 




{'edit 1 : 'visible 1 , 'view': 'visible'} 


show_content_type 




0 


description 
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Widget de type ReferenceWidget 

Boite de saisie pour les references entre les objets Archetypes. 
Proprietes 





Valeur par defaut 


modes 




('view', 'edit') 


populate 


boolean 


1 


macro 




widgets/reference 


postback 


boolean 


1 


label 






visible 




{'edit': 'visible', 'view': 'visible'} 


show_content_type 




0 


description 
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